Google tag API reference | gtag.js | Google for Developers

<!doctype html> <html lang="en" dir="ltr"> <head> <meta name="google-signin-client-id" content="721724668570-nbkv1cfusk7kk4eni4pjvepaus73b13t.apps.googleusercontent.com"> <meta name="google-signin-scope" content="profile email https://www.googleapis.com/auth/developerprofiles https://www.googleapis.com/auth/developerprofiles.award"> <meta property="og:site_name" content="Google for Developers"> <meta property="og:type" content="website"><meta name="theme-color" content="#1a73e8"><meta charset="utf-8"> <meta content="IE=Edge" http-equiv="X-UA-Compatible"> <meta name="viewport" content="width=device-width, initial-scale=1"> <link rel="manifest" href="/_pwa/developers/manifest.json" crossorigin="use-credentials"> <link rel="preconnect" href="//www.gstatic.com" crossorigin> <link rel="preconnect" href="//fonts.gstatic.com" crossorigin> <link rel="preconnect" href="//fonts.googleapis.com" crossorigin> <link rel="preconnect" href="//apis.google.com" crossorigin> <link rel="preconnect" href="//www.google-analytics.com" crossorigin><link rel="stylesheet" href="//fonts.googleapis.com/css?family=Google+Sans:400,500|Roboto:400,400italic,500,500italic,700,700italic|Roboto+Mono:400,500,700&display=swap"> <link rel="stylesheet" href="//fonts.googleapis.com/css2?family=Material+Icons&family=Material+Symbols+Outlined&display=block"><link rel="stylesheet" href="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/css/app.css"> <link rel="shortcut icon" href="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/images/favicon-new.png"> <link rel="apple-touch-icon" href="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/images/touchicon-180-new.png"><link rel="canonical" href="https://developers.google.com/tag-platform/gtagjs/reference"><link rel="search" type="application/opensearchdescription+xml" title="Google for Developers" href="https://developers.google.com/s/opensearch.xml"> <link rel="alternate" hreflang="en" href="https://developers.google.com/tag-platform/gtagjs/reference" /><link rel="alternate" hreflang="x-default" href="https://developers.google.com/tag-platform/gtagjs/reference" /><link rel="alternate" hreflang="ar" href="https://developers.google.com/tag-platform/gtagjs/reference?hl=ar" /><link rel="alternate" hreflang="bn" href="https://developers.google.com/tag-platform/gtagjs/reference?hl=bn" /><link rel="alternate" hreflang="zh-Hans" href="https://developers.google.com/tag-platform/gtagjs/reference?hl=zh-cn" /><link rel="alternate" hreflang="zh-Hant" href="https://developers.google.com/tag-platform/gtagjs/reference?hl=zh-tw" /><link rel="alternate" hreflang="fa" href="https://developers.google.com/tag-platform/gtagjs/reference?hl=fa" /><link rel="alternate" hreflang="fr" href="https://developers.google.com/tag-platform/gtagjs/reference?hl=fr" /><link rel="alternate" hreflang="de" href="https://developers.google.com/tag-platform/gtagjs/reference?hl=de" /><link rel="alternate" hreflang="he" href="https://developers.google.com/tag-platform/gtagjs/reference?hl=he" /><link rel="alternate" hreflang="hi" href="https://developers.google.com/tag-platform/gtagjs/reference?hl=hi" /><link rel="alternate" hreflang="id" href="https://developers.google.com/tag-platform/gtagjs/reference?hl=id" /><link rel="alternate" hreflang="it" href="https://developers.google.com/tag-platform/gtagjs/reference?hl=it" /><link rel="alternate" hreflang="ja" href="https://developers.google.com/tag-platform/gtagjs/reference?hl=ja" /><link rel="alternate" hreflang="ko" href="https://developers.google.com/tag-platform/gtagjs/reference?hl=ko" /><link rel="alternate" hreflang="pl" href="https://developers.google.com/tag-platform/gtagjs/reference?hl=pl" /><link rel="alternate" hreflang="pt-BR" href="https://developers.google.com/tag-platform/gtagjs/reference?hl=pt-br" /><link rel="alternate" hreflang="ru" href="https://developers.google.com/tag-platform/gtagjs/reference?hl=ru" /><link rel="alternate" hreflang="es" href="https://developers.google.com/tag-platform/gtagjs/reference?hl=es" /><link rel="alternate" hreflang="es-419" href="https://developers.google.com/tag-platform/gtagjs/reference?hl=es-419" /><link rel="alternate" hreflang="th" href="https://developers.google.com/tag-platform/gtagjs/reference?hl=th" /><link rel="alternate" hreflang="tr" href="https://developers.google.com/tag-platform/gtagjs/reference?hl=tr" /><link rel="alternate" hreflang="vi" href="https://developers.google.com/tag-platform/gtagjs/reference?hl=vi" /><title>Google tag API reference  |  gtag.js  |  Google for Developers</title> <meta property="og:title" content="Google tag API reference  |  gtag.js  |  Google for Developers"><meta property="og:url" content="https://developers.google.com/tag-platform/gtagjs/reference"><meta property="og:image" content="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/images/opengraph/google-blue.png"> <meta property="og:image:width" content="1200"> <meta property="og:image:height" content="675"><meta property="og:locale" content="en"><meta name="twitter:card" content="summary_large_image"><script type="application/ld+json"> { "@context": "https://schema.org", "@type": "Article", "headline": "Google tag API reference" } </script><script type="application/ld+json"> { "@context": "https://schema.org", "@type": "BreadcrumbList", "itemListElement": [{ "@type": "ListItem", "position": 1, "name": "Tags", "item": "https://developers.google.com/tag-platform" },{ "@type": "ListItem", "position": 2, "name": "gtag.js", "item": "https://developers.google.com/tag-platform/gtagjs" },{ "@type": "ListItem", "position": 3, "name": "Google tag API reference", "item": "https://developers.google.com/tag-platform/gtagjs/reference" }] } </script> <link rel="stylesheet" href="/extras.css"></head> <body class="" template="page" theme="google-blue" type="article" layout="docs" concierge='closed' display-toc pending> <devsite-progress type="indeterminate" id="app-progress"></devsite-progress> <section class="devsite-wrapper"> <devsite-cookie-notification-bar></devsite-cookie-notification-bar><devsite-header role="banner"> <div class="devsite-header--inner nocontent"> <div class="devsite-top-logo-row-wrapper-wrapper"> <div class="devsite-top-logo-row-wrapper"> <div class="devsite-top-logo-row"> <button type="button" id="devsite-hamburger-menu" class="devsite-header-icon-button button-flat material-icons gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Navigation menu button" visually-hidden aria-label="Open menu"> </button> <div class="devsite-product-name-wrapper"> <ul class="devsite-breadcrumb-list" > <li class="devsite-breadcrumb-item "> <a href="https://developers.google.com/tag-platform" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Upper Header" data-value="1" track-type="globalNav" track-name="breadcrumb" track-metadata-position="1" track-metadata-eventdetail="Tags" > Tags </a> </li> </ul> </div> <div class="devsite-top-logo-row-middle"> <div class="devsite-header-upper-tabs"> <devsite-tabs class="upper-tabs"> <nav class="devsite-tabs-wrapper" aria-label="Upper tabs"> <tab > <a href="https://developers.google.com/tag-platform/devguides" track-metadata-eventdetail="https://developers.google.com/tag-platform/devguides" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - the google tag" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: The Google tag" track-name="the google tag" > The Google tag </a> </tab> <tab class="devsite-active"> <a href="https://developers.google.com/tag-platform/gtagjs" track-metadata-eventdetail="https://developers.google.com/tag-platform/gtagjs" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - gtag.js" track-metadata-module="primary nav" aria-label="gtag.js, selected" data-category="Site-Wide Custom Events" data-label="Tab: gtag.js" track-name="gtag.js" > gtag.js </a> </tab> <tab > <a href="https://developers.google.com/tag-platform/tag-manager" track-metadata-eventdetail="https://developers.google.com/tag-platform/tag-manager" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - tag manager" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Tag Manager" track-name="tag manager" > Tag Manager </a> </tab> <tab > <a href="https://developers.google.com/tag-platform/security" track-metadata-eventdetail="https://developers.google.com/tag-platform/security" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - security & privacy" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Security & Privacy" track-name="security & privacy" > Security & Privacy </a> </tab> <tab > <a href="https://developers.google.com/tag-platform/learn" track-metadata-eventdetail="https://developers.google.com/tag-platform/learn" class="devsite-tabs-content gc-analytics-event " track-type="nav" track-metadata-position="nav - learn" track-metadata-module="primary nav" data-category="Site-Wide Custom Events" data-label="Tab: Learn" track-name="learn" > Learn </a> </tab> </nav> </devsite-tabs> </div> <devsite-search enable-signin enable-search enable-suggestions enable-query-completion project-name="gtag.js" tenant-name="Google for Developers" project-scope="/tag-platform/gtagjs" url-scoped="https://developers.google.com/s/results/tag-platform/gtagjs" > <form class="devsite-search-form" action="https://developers.google.com/s/results" method="GET"> <div class="devsite-search-container"> <button type="button" search-open class="devsite-search-button devsite-header-icon-button button-flat material-icons" aria-label="Open search"></button> <div class="devsite-searchbox"> <input aria-activedescendant="" aria-autocomplete="list" aria-label="Search" aria-expanded="false" aria-haspopup="listbox" autocomplete="off" class="devsite-search-field devsite-search-query" name="q" placeholder="Search" role="combobox" type="text" value="" > <div class="devsite-search-image material-icons" aria-hidden="true"> </div> <div class="devsite-search-shortcut-icon-container" aria-hidden="true"> <kbd class="devsite-search-shortcut-icon">/</kbd> </div> </div> </div> </form> <button type="button" search-close class="devsite-search-button devsite-header-icon-button button-flat material-icons" aria-label="Close search"></button> </devsite-search> </div> <devsite-language-selector> <ul role="presentation"> <li role="presentation"> <a role="menuitem" lang="en" >English</a> </li> <li role="presentation"> <a role="menuitem" lang="de" >Deutsch</a> </li> <li role="presentation"> <a role="menuitem" lang="es" >Español</a> </li> <li role="presentation"> <a role="menuitem" lang="es_419" >Español – América Latina</a> </li> <li role="presentation"> <a role="menuitem" lang="fr" >Français</a> </li> <li role="presentation"> <a role="menuitem" lang="id" >Indonesia</a> </li> <li role="presentation"> <a role="menuitem" lang="it" >Italiano</a> </li> <li role="presentation"> <a role="menuitem" lang="pl" >Polski</a> </li> <li role="presentation"> <a role="menuitem" lang="pt_br" >Português – Brasil</a> </li> <li role="presentation"> <a role="menuitem" lang="vi" >Tiếng Việt</a> </li> <li role="presentation"> <a role="menuitem" lang="tr" >Türkçe</a> </li> <li role="presentation"> <a role="menuitem" lang="ru" >Русский</a> </li> <li role="presentation"> <a role="menuitem" lang="he" >עברית</a> </li> <li role="presentation"> <a role="menuitem" lang="ar" >العربيّة</a> </li> <li role="presentation"> <a role="menuitem" lang="fa" >فارسی</a> </li> <li role="presentation"> <a role="menuitem" lang="hi" >हिंदी</a> </li> <li role="presentation"> <a role="menuitem" lang="bn" >বাংলা</a> </li> <li role="presentation"> <a role="menuitem" lang="th" >ภาษาไทย</a> </li> <li role="presentation"> <a role="menuitem" lang="zh_cn" >中文 – 简体</a> </li> <li role="presentation"> <a role="menuitem" lang="zh_tw" >中文 – 繁體</a> </li> <li role="presentation"> <a role="menuitem" lang="ja" >日本語</a> </li> <li role="presentation"> <a role="menuitem" lang="ko" >한국어</a> </li> </ul> </devsite-language-selector> <devsite-user enable-profiles fp-auth id="devsite-user"> Sign in </devsite-user> </div> </div> </div> <div class="devsite-collapsible-section devsite-header-no-lower-tabs "> <div class="devsite-header-background"> <div class="devsite-product-id-row" > <div class="devsite-product-description-row"> <ul class="devsite-breadcrumb-list" > <li class="devsite-breadcrumb-item "> <a href="https://developers.google.com/tag-platform/gtagjs" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Lower Header" data-value="1" track-type="globalNav" track-name="breadcrumb" track-metadata-position="1" track-metadata-eventdetail="gtag.js" > gtag.js </a> </li> </ul> </div> <div class="devsite-product-button-row"> <a href="https://tagmanager.google.com/" class="button " >Open Google Tag Manager</a> </div> </div> </div> </div> </div> </devsite-header> <devsite-book-nav scrollbars > <div class="devsite-book-nav-filter" > <input type="text" placeholder="Filter" aria-label="Type to filter" role="searchbox"> </div> <nav class="devsite-book-nav devsite-nav nocontent" aria-label="Side menu"> <div class="devsite-mobile-header"> <button type="button" id="devsite-close-nav" class="devsite-header-icon-button button-flat material-icons gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Close navigation" aria-label="Close navigation"> </button> <div class="devsite-product-name-wrapper"> <ul class="devsite-breadcrumb-list" > <li class="devsite-breadcrumb-item "> <a href="https://developers.google.com/tag-platform" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Upper Header" data-value="1" track-type="globalNav" track-name="breadcrumb" track-metadata-position="1" track-metadata-eventdetail="Tags" > Tags </a> </li> </ul> </div> </div> <div class="devsite-book-nav-wrapper"> <div class="devsite-mobile-nav-top"> <ul class="devsite-nav-list"> <li class="devsite-nav-item"> <a href="/tag-platform/devguides" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Tab: The Google tag" track-name="the google tag" data-category="Site-Wide Custom Events" data-label="Responsive Tab: The Google tag" track-type="globalNav" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> The Google tag </a> </li> <li class="devsite-nav-item"> <a href="/tag-platform/gtagjs" class="devsite-nav-title gc-analytics-event devsite-nav-has-children devsite-nav-active" data-category="Site-Wide Custom Events" data-label="Tab: gtag.js" track-name="gtag.js" data-category="Site-Wide Custom Events" data-label="Responsive Tab: gtag.js" track-type="globalNav" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> gtag.js </a> </li> <li class="devsite-nav-item"> <a href="/tag-platform/tag-manager" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Tab: Tag Manager" track-name="tag manager" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Tag Manager" track-type="globalNav" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Tag Manager </a> </li> <li class="devsite-nav-item"> <a href="/tag-platform/security" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Tab: Security & Privacy" track-name="security & privacy" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Security & Privacy" track-type="globalNav" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Security & Privacy </a> </li> <li class="devsite-nav-item"> <a href="/tag-platform/learn" class="devsite-nav-title gc-analytics-event " data-category="Site-Wide Custom Events" data-label="Tab: Learn" track-name="learn" data-category="Site-Wide Custom Events" data-label="Responsive Tab: Learn" track-type="globalNav" track-metadata-eventDetail="globalMenu" track-metadata-position="nav"> Learn </a> </li> </ul> </div> <div class="devsite-mobile-nav-bottom"> <ul class="devsite-nav-list" menu="_book"> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> Get started </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/tag-platform/gtagjs" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /tag-platform/gtagjs" track-type="bookNav" track-name="click" track-metadata-eventdetail="/tag-platform/gtagjs" >Set up the Google tag with gtag.js</a></li><li class="devsite-nav-item"><a href="/tag-platform/gtagjs/configure" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /tag-platform/gtagjs/configure" track-type="bookNav" track-name="click" track-metadata-eventdetail="/tag-platform/gtagjs/configure" >Configure Google products with gtag.js</a></li><li class="devsite-nav-item"><a href="/tag-platform/gtagjs/routing" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /tag-platform/gtagjs/routing" track-type="bookNav" track-name="click" track-metadata-eventdetail="/tag-platform/gtagjs/routing" >Group and route data with gtag.js</a></li></ul></li> <li class="devsite-nav-item devsite-nav-heading"><div class="devsite-nav-title devsite-nav-title-no-path"> Reference </div><ul class="devsite-nav-section"><li class="devsite-nav-item"><a href="/tag-platform/gtagjs/reference" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /tag-platform/gtagjs/reference" track-type="bookNav" track-name="click" track-metadata-eventdetail="/tag-platform/gtagjs/reference" >gtag.js API</a></li><li class="devsite-nav-item"><a href="/tag-platform/gtagjs/reference/parameters" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /tag-platform/gtagjs/reference/parameters" track-type="bookNav" track-name="click" track-metadata-eventdetail="/tag-platform/gtagjs/reference/parameters" >gtag.js parameters</a></li><li class="devsite-nav-item"><a href="/tag-platform/gtagjs/reference/events" class="devsite-nav-title gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Book nav link, pathname: /tag-platform/gtagjs/reference/events" track-type="bookNav" track-name="click" track-metadata-eventdetail="/tag-platform/gtagjs/reference/events" >Events</a></li></ul></li> </ul> </div> </div> </nav> </devsite-book-nav> <section id="gc-wrapper"> <main role="main" class="devsite-main-content" has-book-nav > <devsite-content> <article class="devsite-article"> <div class="devsite-article-meta nocontent" role="navigation"> <ul class="devsite-breadcrumb-list" aria-label="Breadcrumb"> <li class="devsite-breadcrumb-item "> <a href="https://developers.google.com/" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="1" track-type="globalNav" track-name="breadcrumb" track-metadata-position="1" track-metadata-eventdetail="" > Home </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://developers.google.com/products" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="2" track-type="globalNav" track-name="breadcrumb" track-metadata-position="2" track-metadata-eventdetail="" > Products </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://developers.google.com/tag-platform" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="3" track-type="globalNav" track-name="breadcrumb" track-metadata-position="3" track-metadata-eventdetail="Tags" > Tags </a> </li> <li class="devsite-breadcrumb-item "> <div class="devsite-breadcrumb-guillemet material-icons" aria-hidden="true"></div> <a href="https://developers.google.com/tag-platform/gtagjs" class="devsite-breadcrumb-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Breadcrumbs" data-value="4" track-type="globalNav" track-name="breadcrumb" track-metadata-position="4" track-metadata-eventdetail="gtag.js" > gtag.js </a> </li> </ul> <devsite-thumb-rating position="header"> </devsite-thumb-rating> </div> <devsite-feedback position="header" project-name="gtag.js" product-id="102259" bucket="tag-platform" context="" version="t-devsite-webserver-20241114-r00-rc02.464922260396498922" data-label="Send Feedback Button" track-type="feedback" track-name="sendFeedbackLink" track-metadata-position="header" class="nocontent" project-icon="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/images/touchicon-180-new.png" project-support-url="https://developers.google.com/tag-platform/support" > <button> Send feedback </button> </devsite-feedback> <h1 class="devsite-page-title" tabindex="-1"> Google tag API reference </h1> <devsite-feature-tooltip ack-key="AckCollectionsBookmarkTooltipDismiss" analytics-category="Site-Wide Custom Events" analytics-action-show="Callout Profile displayed" analytics-action-close="Callout Profile dismissed" analytics-label="Create Collection Callout" class="devsite-page-bookmark-tooltip nocontent" dismiss-button="true" id="devsite-collections-dropdown" dismiss-button-text="Dismiss" close-button-text="Got it"> <devsite-bookmark></devsite-bookmark> Stay organized with collections Save and categorize content based on your preferences. </devsite-feature-tooltip> <div class="devsite-page-title-meta"><devsite-view-release-notes></devsite-view-release-notes></div> <devsite-toc class="devsite-nav" depth="2" devsite-toc-embedded > </devsite-toc> <div class="devsite-article-body clearfix "> The Google tag (gtag.js) API consists of a single function, <code translate="no" dir="ltr">gtag()</code>, with the following syntax: <div></div><devsite-code><pre class="devsite-click-to-copy" translate="no" dir="ltr" is-upgraded syntax="JavaScript"><code translate="no" dir="ltr">gtag(<command>, <command parameters>); </code></pre></devsite-code> <ul> <li><code translate="no" dir="ltr"><command></code> is one of the following commands: <ul> <li><a href="#config"><code translate="no" dir="ltr">config</code></a></li> <li><a href="#get"><code translate="no" dir="ltr">get</code></a></li> <li><a href="#set"><code translate="no" dir="ltr">set</code></a></li> <li><a href="#event"><code translate="no" dir="ltr">event</code></a></li> <li><a href="#consent"><code translate="no" dir="ltr">consent</code></a></li> </ul></li> <li><code translate="no" dir="ltr"><command parameters></code> are the parameters you can pass to <code translate="no" dir="ltr">gtag()</code>. Command parameters vary according to the command; refer to the command reference, below.</li> </ul> You can invoke <code translate="no" dir="ltr">gtag()</code> commands anywhere on your page, as long as your commands appear below the Google tag snippet. To learn how to add the snippet to a page, see <a href="/tag-platform/gtagjs/install">the installation guide</a>. <h2 id="parameter_scope" data-text="Parameter scope" tabindex="-1">Parameter scope</h2> You can scope parameters values to individual events, all events sent to a specific <code translate="no" dir="ltr"><TARGET_ID></code> , or globally to all events. This is achieved by using the <code translate="no" dir="ltr">event</code>, <code translate="no" dir="ltr">config</code>, and <code translate="no" dir="ltr">set</code> commands. Parameter values set in one scope don't modify the values set for the same parameter in a different scope. In the example below, the <code translate="no" dir="ltr">config</code> command does not modify the global value for <code translate="no" dir="ltr">campaign_id</code> previously assigned with the <code translate="no" dir="ltr">set</code> command. After both commands are executed, the global value of <code translate="no" dir="ltr">campaign_id</code> is still <code translate="no" dir="ltr">'1234'</code>. <div></div><devsite-code><pre class="devsite-click-to-copy" translate="no" dir="ltr" is-upgraded syntax="JavaScript"><code translate="no" dir="ltr">// Set global campaign ID gtag('set', { 'campaign_id': '1234' }); // Set campaign ID for <TARGET_ID> gtag('config','<TARGET_ID>', { 'campaign_id': 'ABCD' }); </code></pre></devsite-code> <h2 id="parameter_precedence" data-text="Parameter precedence" tabindex="-1">Parameter precedence</h2> If different values are assigned to the same parameter in different scopes, only a single value is used when processing events. Parameter values scoped to <code translate="no" dir="ltr">event</code> will take precedence over parameters scoped to <code translate="no" dir="ltr">config</code>, and <code translate="no" dir="ltr">config</code> parameters take precedence over parameters that are globally scoped using <code translate="no" dir="ltr">set</code>. <div></div><devsite-code><pre class="devsite-click-to-copy" translate="no" dir="ltr" is-upgraded syntax="JavaScript"><code translate="no" dir="ltr">// Set campaign information at the global scope gtag('set', { 'campaign_name': 'Black Friday Sale' }); // Set currency for <TARGET_ID1> to 'USD' gtag('config','<TARGET_ID1>', { 'currency': 'USD' }); // Process a conversion event with currency: 'GBP' gtag('event','conversion', { 'currency': 'GBP', 'send_to': '<TARGET_ID1>' }); // Process a conversion event with currency: 'EUR' gtag('event','conversion'); // Process a conversion event with currency: 'USD' gtag('event','conversion', { 'send_to': '<TARGET_ID1>' }); </code></pre></devsite-code> <h2 id="config" data-text="config" tabindex="-1"><code translate="no" dir="ltr">config</code></h2> Allows you to add additional configuration information to targets. This is typically a product-specific configuration for a product, but you only need to configure this once if you're using both Google Ads and Google Analytics. <div></div><devsite-code><pre class="devsite-click-to-copy" translate="no" dir="ltr" is-upgraded syntax="JavaScript"><code translate="no" dir="ltr">gtag('config', '<TARGET_ID>', {<additional_config_info>}); </code></pre></devsite-code> <code translate="no" dir="ltr"><TARGET_ID></code> is an identifier that uniquely identifies the target for hits, such as a Google Analytics property or a Google Ads account. <code translate="no" dir="ltr"><additional_config_info></code> is one or more parameter-value pairs. This example configures a tag to send data to a Google Ads account: <div></div><devsite-code><pre class="devsite-click-to-copy" translate="no" dir="ltr" is-upgraded syntax="JavaScript"><code translate="no" dir="ltr">gtag('config', 'TAG_ID'); </code></pre></devsite-code> where "TAG_ID" is the <a href="https://support.google.com/tagmanager/answer/12326985">tag ID</a> for the Google tag. To demonstrate how to send additional config information, here is an example that configures a tag to send data to an Analytics account with a <code translate="no" dir="ltr">send_page_view</code> parameter that passes a value of <code translate="no" dir="ltr">false</code>, and a <code translate="no" dir="ltr">groups</code> parameter that passes a value of <code translate="no" dir="ltr">'agency'</code>. <div></div><devsite-code><pre class="devsite-click-to-copy" translate="no" dir="ltr" is-upgraded syntax="JavaScript"><code translate="no" dir="ltr">gtag('config', 'TAG_ID', { 'send_page_view': false, 'groups': 'agency' }); </code></pre></devsite-code> <h2 id="get" data-text="get" tabindex="-1"><code translate="no" dir="ltr">get</code></h2> Allows you to get various values from <code translate="no" dir="ltr">gtag.js</code> including values set with the <a href="#set"><code translate="no" dir="ltr">set</code></a> command. <div></div><devsite-code><pre class="devsite-click-to-copy" translate="no" dir="ltr" is-upgraded syntax="JavaScript"><code translate="no" dir="ltr">gtag('get', '<target>', '<field_name>', callback) </code></pre></devsite-code> <table> <tr> <th>Argument</th> <th>Type</th> <th>Example</th> <th>Description</th> </tr> <tr> <td><target></td> <td><code translate="no" dir="ltr">string</code></td> <td>G-XXXXXXXXXX</td> <td> The target to fetch values from. </td> </tr> <tr> <td><field_name></td> <td><a href="#get_field_name">FieldName</a></td> <td>client_id</td> <td>The name of the field to get.</td> </tr> <tr> <td>callback</td> <td><code translate="no" dir="ltr">Function</code></td> <td><code translate="no" dir="ltr">(field) => console.log(field)</code></td> <td> A function that will be invoked with the requested field, or <code translate="no" dir="ltr">undefined</code> if it is unset. </td> </tr> </table> FieldName Field name can be the name of a custom field you set with the <code translate="no" dir="ltr">gtag('set')</code> command, or one of the following values: <table> <tr> <th>Field Name</th> <th>Supported Targets</th> </tr> <tr> <td>client_id</td> <td> <ul> <li>Google Analytics 4</li> </ul> </td> </tr> <tr> <td>session_id</td> <td> <ul> <li>Google Analytics 4</li> </ul> </td> </tr> <tr> <td>gclid</td> <td> <ul> <li>Google Ads</li> <li>Floodlight</li> </ul> </td> </tr> </table> <aside class="note">Note: If you use the <a href="#set"><code translate="no" dir="ltr">set</code></a> command with these field names, the value you set will have precedence.</aside> <h3 id="set_examples" class="hide-from-toc" data-text="Examples" tabindex="-1">Examples</h3> Get value into a Promise <div></div><devsite-code><pre class="devsite-click-to-copy" translate="no" dir="ltr" is-upgraded syntax="JavaScript"><code translate="no" dir="ltr">const gclidPromise = new Promise(resolve => { gtag('get', 'DC-XXXXXXXX', 'gclid', resolve) }); gclidPromise.then((gclid) => { // Do something with gclid... }) </code></pre></devsite-code> Send event to the Measurement Protocol <div></div><devsite-code><pre class="devsite-click-to-copy" translate="no" dir="ltr" is-upgraded syntax="JavaScript"><code translate="no" dir="ltr">gtag('get', 'G-XXXXXXXXXX', 'client_id', (clientID) => { sendOfflineEvent(clientID, "tutorial_begin") }); function sendOfflineEvent(clientID, eventName, eventData) { // Send necessary data to your server... } </code></pre></devsite-code> Get a value you set <div></div><devsite-code><pre class="devsite-click-to-copy" translate="no" dir="ltr" is-upgraded syntax="JavaScript"><code translate="no" dir="ltr">gtag('set', {campaign_name: 'Spring_Sale'}); gtag('get', 'G-XXXXXXXXXX', 'campaign_name', (campaign_name) => { // Do something with currency value you set earlier. }) </code></pre></devsite-code> <h2 id="set" data-text="set" tabindex="-1"><code translate="no" dir="ltr">set</code></h2> The set command lets you define parameters that will be associated with every subsequent event on the page. <aside class="note">Note: We recommend using <a href="#config"><code translate="no" dir="ltr">config</code></a> or <a href="#event"><code translate="no" dir="ltr">event</code></a> commands wherever possible.</aside><div></div><devsite-code><pre class="devsite-click-to-copy" translate="no" dir="ltr" is-upgraded syntax="JavaScript"><code translate="no" dir="ltr">gtag('set', {<parameter-value-pair>, <parameter-value-pair>}); </code></pre></devsite-code> For example, you can share <a href="https://developers.google.com/analytics/devguides/collection/ga4/reference/config#campaign">campaign</a> parameters so that they can be accessed by multiple tags on the same page. The example below illustrates setting a campaign name and ID for a black Friday shopping event. Because you've used <code translate="no" dir="ltr">set</code>, all other tags, for example, GA4 Event tags or Google Ads Remarketing tags, can access this data. <div></div><devsite-code><pre class="devsite-click-to-copy" translate="no" dir="ltr" is-upgraded syntax="JavaScript"><code translate="no" dir="ltr">gtag('set', 'campaign', { 'id': 'abc', 'source': 'google', 'name': 'black_friday_promotion', 'term': 'running+shoes', }); </code></pre></devsite-code> <h2 id="event" data-text="event" tabindex="-1"><code translate="no" dir="ltr">event</code></h2> Use the <code translate="no" dir="ltr">event</code> command to send event data. <div></div><devsite-code><pre class="devsite-click-to-copy" translate="no" dir="ltr" is-upgraded syntax="JavaScript"><code translate="no" dir="ltr">gtag('event', '<event_name>', {<event_params>}); </code></pre></devsite-code> <code translate="no" dir="ltr"><event_name></code> is either: <ul> <li>A <a href="/tag-platform/gtagjs/reference/events">recommended event</a>. Each recommended event can take <a href="/tag-platform/gtagjs/reference/parameters">recommended parameters</a>.</li> <li>A custom event. A custom event is an arbitrary event name that you make up, with arbitrary parameters. For more information, see <a href="/analytics/devguides/collection/ga4/events">Set up events</a>.</li> </ul> <code translate="no" dir="ltr"><event_params></code> is one or more parameter-value pairs. Each pair separated by a comma. The following <code translate="no" dir="ltr">event</code> command fires the recommended event <code translate="no" dir="ltr">screen_view</code> with two parameters: <code translate="no" dir="ltr">app_name</code> and <code translate="no" dir="ltr">screen_name</code>. <div></div><devsite-code><pre class="devsite-click-to-copy" translate="no" dir="ltr" is-upgraded syntax="JavaScript"><code translate="no" dir="ltr">gtag('event', 'screen_view', { 'app_name': 'myAppName', 'screen_name': 'Home' }); </code></pre></devsite-code><aside class="special">Important: The Google tag snippet must appear on the same page, above <code translate="no" dir="ltr">event</code> commands, or your data will not be sent.</aside> <h2 id="consent" data-text="consent" tabindex="-1"><code translate="no" dir="ltr">consent</code></h2> Use the <code translate="no" dir="ltr">consent</code> command to configure consent. <div></div><devsite-code><pre class="devsite-click-to-copy" translate="no" dir="ltr" is-upgraded syntax="JavaScript"><code translate="no" dir="ltr">gtag('consent', {<consent_arg>}, {<consent_params>}); </code></pre></devsite-code> See <a href="https://support.google.com/analytics/answer/9976101">consent</a> in the help center for more information on the behavior these parameters configure. <code translate="no" dir="ltr"><consent_arg></code> is one of <code translate="no" dir="ltr">'default'</code> or <code translate="no" dir="ltr">'update'</code>. <code translate="no" dir="ltr">'default'</code> is used to set the default consent parameters that should be used, and <code translate="no" dir="ltr">'update'</code> is used to update these parameters once a user indicates their consent. The following <code translate="no" dir="ltr"><consent_params></code> are supported: <table> <tr> <th>Field Name</th> <th>Allowed Values</th> <th>Description</th> </tr> <tr> <td><code translate="no" dir="ltr">ad_storage</code></td> <td><code translate="no" dir="ltr">'granted'</code> | <code translate="no" dir="ltr">'denied'</code></td> <td>Enables storage, such as cookies (web) or device identifiers (apps), related to advertising.</td> </tr> <tr> <td><code translate="no" dir="ltr">ad_user_data</code></td> <td><code translate="no" dir="ltr">'granted'</code> | <code translate="no" dir="ltr">'denied'</code></td> <td>Sets consent for sending user data to Google for advertising purposes.</td> </tr> <tr> <td><code translate="no" dir="ltr">ad_personalization</code></td> <td><code translate="no" dir="ltr">'granted'</code> | <code translate="no" dir="ltr">'denied'</code></td> <td>Sets consent for personalized advertising.</td> </tr> <tr> <td><code translate="no" dir="ltr">analytics_storage</code></td> <td><code translate="no" dir="ltr">'granted'</code> | <code translate="no" dir="ltr">'denied'</code></td> <td>Enables storage, such as cookies (web) or app identifiers (apps), related to analytics, e.g. visit duration.</td> </tr> <tr> <td><code translate="no" dir="ltr">wait_for_update</code></td> <td>any positive integer</td> <td>Sets a time in milliseconds to wait for a consent update call.</td> </tr> </table> </div> <devsite-recommendations display="in-page" hidden yield> </devsite-recommendations> <devsite-thumb-rating position="footer"> </devsite-thumb-rating> <devsite-feedback position="footer" project-name="gtag.js" product-id="102259" bucket="tag-platform" context="" version="t-devsite-webserver-20241114-r00-rc02.464922260396498922" data-label="Send Feedback Button" track-type="feedback" track-name="sendFeedbackLink" track-metadata-position="footer" class="nocontent" project-icon="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/images/touchicon-180-new.png" project-support-url="https://developers.google.com/tag-platform/support" > <button> Send feedback </button> </devsite-feedback> <devsite-recommendations id="recommendations-link" yield></devsite-recommendations> <div class="devsite-floating-action-buttons"> </div> </article> <devsite-content-footer class="nocontent"> Except as otherwise noted, the content of this page is licensed under the <a href="https://creativecommons.org/licenses/by/4.0/">Creative Commons Attribution 4.0 License</a>, and code samples are licensed under the <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache 2.0 License</a>. For details, see the <a href="https://developers.google.com/site-policies">Google Developers Site Policies</a>. Java is a registered trademark of Oracle and/or its affiliates. Last updated 2024-11-12 UTC. </devsite-content-footer> <devsite-notification > </devsite-notification> <div class="devsite-content-data"> <template class="devsite-thumb-rating-feedback"> <devsite-feedback position="thumb-rating" project-name="gtag.js" product-id="102259" bucket="tag-platform" context="" version="t-devsite-webserver-20241114-r00-rc02.464922260396498922" data-label="Send Feedback Button" track-type="feedback" track-name="sendFeedbackLink" track-metadata-position="thumb-rating" class="nocontent" project-icon="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/images/touchicon-180-new.png" project-support-url="https://developers.google.com/tag-platform/support" > <button> Need to tell us more? </button> </devsite-feedback> </template> <template class="devsite-content-data-template"> [[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-11-12 UTC."],[],[]] </template> </div> </devsite-content> </main> <devsite-footer-promos class="devsite-footer"> </devsite-footer-promos> <devsite-footer-linkboxes class="devsite-footer"> <nav class="devsite-footer-linkboxes nocontent" aria-label="Footer links"> <ul class="devsite-footer-linkboxes-list"> <li class="devsite-footer-linkbox "> <h3 class="devsite-footer-linkbox-heading no-link">Connect</h3> <ul class="devsite-footer-linkbox-list"> <li class="devsite-footer-linkbox-item"> <a href="//googledevelopers.blogspot.com" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 1)" > Blog </a> </li> <li class="devsite-footer-linkbox-item"> <a href="https://www.instagram.com/googlefordevs/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 2)" > Instagram </a> </li> <li class="devsite-footer-linkbox-item"> <a href="https://www.linkedin.com/showcase/googledevelopers/" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 3)" > LinkedIn </a> </li> <li class="devsite-footer-linkbox-item"> <a href="//twitter.com/googledevs" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 4)" > X (Twitter) </a> </li> <li class="devsite-footer-linkbox-item"> <a href="//www.youtube.com/user/GoogleDevelopers" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 5)" > YouTube </a> </li> </ul> </li> <li class="devsite-footer-linkbox "> <h3 class="devsite-footer-linkbox-heading no-link">Programs</h3> <ul class="devsite-footer-linkbox-list"> <li class="devsite-footer-linkbox-item"> <a href="//www.womentechmakers.com" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 1)" > Women Techmakers </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/community/gdg" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 2)" > Google Developer Groups </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/community/experts" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 3)" > Google Developer Experts </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/community/accelerators" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 4)" > Accelerators </a> </li> <li class="devsite-footer-linkbox-item"> <a href="/community/gdsc" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 5)" > Google Developer Student Clubs </a> </li> </ul> </li> <li class="devsite-footer-linkbox "> <h3 class="devsite-footer-linkbox-heading no-link">Developer consoles</h3> <ul class="devsite-footer-linkbox-list"> <li class="devsite-footer-linkbox-item"> <a href="//console.developers.google.com" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 1)" > Google API Console </a> </li> <li class="devsite-footer-linkbox-item"> <a href="//console.cloud.google.com" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 2)" > Google Cloud Platform Console </a> </li> <li class="devsite-footer-linkbox-item"> <a href="//play.google.com/apps/publish" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 3)" > Google Play Console </a> </li> <li class="devsite-footer-linkbox-item"> <a href="//console.firebase.google.com" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 4)" > Firebase Console </a> </li> <li class="devsite-footer-linkbox-item"> <a href="//console.actions.google.com" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 5)" > Actions on Google Console </a> </li> <li class="devsite-footer-linkbox-item"> <a href="//cast.google.com/publish" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 6)" > Cast SDK Developer Console </a> </li> <li class="devsite-footer-linkbox-item"> <a href="//chrome.google.com/webstore/developer/dashboard" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 7)" > Chrome Web Store Dashboard </a> </li> <li class="devsite-footer-linkbox-item"> <a href="//console.home.google.com" class="devsite-footer-linkbox-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Link (index 8)" > Google Home Developer Console </a> </li> </ul> </li> </ul> </nav> </devsite-footer-linkboxes> <devsite-footer-utility class="devsite-footer"> <div class="devsite-footer-utility nocontent"> <nav class="devsite-footer-sites" aria-label="Other Google Developers websites"> <a href="https://developers.google.com/" class="devsite-footer-sites-logo-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Google Developers Link"> <picture> <img class="devsite-footer-sites-logo" src="https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/images/lockup-google-for-developers.svg" loading="lazy" alt="Google Developers"> </picture> </a> <ul class="devsite-footer-sites-list"> <li class="devsite-footer-sites-item"> <a href="//developer.android.com" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Android Link" > Android </a> </li> <li class="devsite-footer-sites-item"> <a href="//developer.chrome.com/home" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Chrome Link" > Chrome </a> </li> <li class="devsite-footer-sites-item"> <a href="//firebase.google.com" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Firebase Link" > Firebase </a> </li> <li class="devsite-footer-sites-item"> <a href="//cloud.google.com" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Google Cloud Platform Link" > Google Cloud Platform </a> </li> <li class="devsite-footer-sites-item"> <a href="//ai.google.dev/" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer Google AI Link" > Google AI </a> </li> <li class="devsite-footer-sites-item"> <a href="/products" class="devsite-footer-sites-link gc-analytics-event" data-category="Site-Wide Custom Events" data-label="Footer All products Link" > All products </a> </li> </ul> </nav> <nav class="devsite-footer-utility-links" aria-label="Utility links"> <ul class="devsite-footer-utility-list"> <li class="devsite-footer-utility-item "> <a class="devsite-footer-utility-link gc-analytics-event" href="/terms/site-terms" data-category="Site-Wide Custom Events" data-label="Footer Terms link" > Terms </a> </li> <li class="devsite-footer-utility-item "> <a class="devsite-footer-utility-link gc-analytics-event" href="//policies.google.com/privacy" data-category="Site-Wide Custom Events" data-label="Footer Privacy link" > Privacy </a> </li> <li class="devsite-footer-utility-item glue-cookie-notification-bar-control"> <a class="devsite-footer-utility-link gc-analytics-event" href="#" data-category="Site-Wide Custom Events" data-label="Footer Manage cookies link" aria-hidden="true" > Manage cookies </a> </li> <li class="devsite-footer-utility-item devsite-footer-utility-button"> Sign up for the Google for Developers newsletter <a class="devsite-footer-utility-link gc-analytics-event" href="/newsletter/subscribe" data-category="Site-Wide Custom Events" data-label="Footer Subscribe link" > Subscribe </a> </li> </ul> <devsite-language-selector> <ul role="presentation"> <li role="presentation"> <a role="menuitem" lang="en" >English</a> </li> <li role="presentation"> <a role="menuitem" lang="de" >Deutsch</a> </li> <li role="presentation"> <a role="menuitem" lang="es" >Español</a> </li> <li role="presentation"> <a role="menuitem" lang="es_419" >Español – América Latina</a> </li> <li role="presentation"> <a role="menuitem" lang="fr" >Français</a> </li> <li role="presentation"> <a role="menuitem" lang="id" >Indonesia</a> </li> <li role="presentation"> <a role="menuitem" lang="it" >Italiano</a> </li> <li role="presentation"> <a role="menuitem" lang="pl" >Polski</a> </li> <li role="presentation"> <a role="menuitem" lang="pt_br" >Português – Brasil</a> </li> <li role="presentation"> <a role="menuitem" lang="vi" >Tiếng Việt</a> </li> <li role="presentation"> <a role="menuitem" lang="tr" >Türkçe</a> </li> <li role="presentation"> <a role="menuitem" lang="ru" >Русский</a> </li> <li role="presentation"> <a role="menuitem" lang="he" >עברית</a> </li> <li role="presentation"> <a role="menuitem" lang="ar" >العربيّة</a> </li> <li role="presentation"> <a role="menuitem" lang="fa" >فارسی</a> </li> <li role="presentation"> <a role="menuitem" lang="hi" >हिंदी</a> </li> <li role="presentation"> <a role="menuitem" lang="bn" >বাংলা</a> </li> <li role="presentation"> <a role="menuitem" lang="th" >ภาษาไทย</a> </li> <li role="presentation"> <a role="menuitem" lang="zh_cn" >中文 – 简体</a> </li> <li role="presentation"> <a role="menuitem" lang="zh_tw" >中文 – 繁體</a> </li> <li role="presentation"> <a role="menuitem" lang="ja" >日本語</a> </li> <li role="presentation"> <a role="menuitem" lang="ko" >한국어</a> </li> </ul> </devsite-language-selector> </nav> </div> </devsite-footer-utility> <devsite-panel></devsite-panel> <devsite-concierge data-info-panel data-ai-panel data-api-explorer-panel > </devsite-concierge> </section></section> <devsite-sitemask></devsite-sitemask> <devsite-snackbar></devsite-snackbar> <devsite-tooltip ></devsite-tooltip> <devsite-heading-link></devsite-heading-link> <devsite-analytics> <script type="application/json" analytics>[{"dimensions": {"dimension6": "en", "dimension11": false, "dimension5": "en", "dimension1": "Signed out", "dimension4": "gtag.js", "dimension3": false}, "gaid": "UA-24532603-1", "metrics": {"ratings_count": "metric2", "ratings_value": "metric1"}, "purpose": 1}]</script> <script type="application/json" tag-management>{"at": "True", "ga4": [{"id": "G-272J68FCRF", "purpose": 1}, {"id": "G-7GV7GNWXNZ", "purpose": 0}], "ga4p": [{"id": "G-272J68FCRF", "purpose": 1}], "gtm": [], "parameters": {"internalUser": "False", "language": {"machineTranslated": "False", "requested": "en", "served": "en"}, "pageType": "article", "projectName": "gtag.js", "signedIn": "False", "tenant": "developers", "recommendations": {"sourcePage": "", "sourceType": 0, "sourceRank": 0, "sourceIdenticalDescriptions": 0, "sourceTitleWords": 0, "sourceDescriptionWords": 0, "experiment": ""}, "experiment": {"ids": ""}}}</script> </devsite-analytics> <devsite-badger></devsite-badger> <script nonce="vmBKoaq2ogGixiCU9j+t1FQJYmFZUU"> (function(d,e,v,s,i,t,E){d['GoogleDevelopersObject']=i; t=e.createElement(v);t.async=1;t.src=s;E=e.getElementsByTagName(v)[0]; E.parentNode.insertBefore(t,E);})(window, document, 'script', 'https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/js/app_loader.js', '[1,"en",null,"/js/devsite_app_module.js","https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625","https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers","https://developers-dot-devsite-v2-prod.appspot.com",1,null,["/_pwa/developers/manifest.json","https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/images/video-placeholder.svg","https://www.gstatic.com/devrel-devsite/prod/v870e399c64f7c43c99a3043db4b3a74327bb93d0914e84a0c3dba90bbfd67625/developers/images/favicon-new.png","https://fonts.googleapis.com/css?family=Google+Sans:400,500|Roboto:400,400italic,500,500italic,700,700italic|Roboto+Mono:400,500,700&display=swap"],1,null,[1,6,8,12,14,17,21,25,50,52,63,70,75,76,80,87,91,92,93,97,98,100,101,102,103,104,105,107,108,109,110,112,113,116,117,118,120,122,124,125,126,127,129,130,131,132,133,134,135,136,138,140,141,147,148,149,151,152,156,157,158,159,161,163,164,168,169,170,179,180,182,183,186,191,193,196],"AIzaSyAP-jjEJBzmIyKR4F-3XITp8yM9T1gEEI8","AIzaSyB6xiKGDR5O3Ak2okS4rLkauxGUG7XP0hg","developers.google.com","AIzaSyAQk0fBONSGUqCNznf6Krs82Ap1-NV6J4o","AIzaSyCCxcqdrZ_7QMeLCRY20bh_SXdAYqy70KY",null,null,null,["Profiles__enable_profile_collections","Cloud__enable_cloud_facet_chat","Significatio__enable_by_tenant","Cloud__enable_llm_concierge_chat","MiscFeatureFlags__enable_variable_operator","Experiments__reqs_query_experiments","Profiles__enable_completecodelab_endpoint","Profiles__enable_public_developer_profiles","MiscFeatureFlags__enable_explain_this_code","Cloud__enable_cloud_shell_fte_user_flow","MiscFeatureFlags__developers_footer_dark_image","DevPro__enable_developer_subscriptions","Cloud__enable_legacy_calculator_redirect","Concierge__enable_pushui","Cloud__enable_free_trial_server_call","Search__enable_ai_eligibility_checks","Profiles__require_profile_eligibility_for_signin","TpcFeatures__enable_required_headers","Profiles__enable_dashboard_curated_recommendations","Profiles__enable_complete_playlist_endpoint","MiscFeatureFlags__developers_footer_image","MiscFeatureFlags__emergency_css","EngEduTelemetry__enable_engedu_telemetry","Search__enable_page_map","MiscFeatureFlags__enable_project_variables","Cloud__enable_cloud_dlp_service","CloudShell__cloud_code_overflow_menu","Cloud__enable_cloudx_ping","BookNav__enable_tenant_cache_key","Concierge__enable_concierge","Cloud__enable_cloudx_experiment_ids","Profiles__enable_page_saving","Profiles__enable_release_notes_notifications","Cloud__enable_cloud_shell","Search__enable_dynamic_content_confidential_banner","TpcFeatures__enable_mirror_tenant_redirects","Analytics__enable_clearcut_logging","Search__enable_suggestions_from_borg","Search__enable_ai_search_summaries","Profiles__enable_awarding_url","MiscFeatureFlags__enable_firebase_utm","Profiles__enable_recognition_badges","CloudShell__cloud_shell_button","Concierge__enable_concierge_restricted","MiscFeatureFlags__enable_view_transitions","Profiles__enable_developer_profiles_callout","Search__enable_ai_search_summaries_restricted","DevPro__enable_cloud_innovators_plus"],null,null,"AIzaSyBLEMok-5suZ67qRPzx0qUtbnLmyT_kCVE","https://developerscontentserving-pa.clients6.google.com","AIzaSyCM4QpTRSqP5qI4Dvjt4OAScIN8sOUlO-k","https://developerscontentsearch-pa.clients6.google.com",1,4,null,"https://developerprofiles-pa.clients6.google.com",[1,"developers","Google for Developers","developers.google.com",null,"developers-dot-devsite-v2-prod.appspot.com",null,null,[1,1,[1],null,null,null,null,null,null,null,null,[1],null,null,null,null,null,null,[1],[1,null,null,[1,20],"/recommendations/information"],null,null,null,[1,1,1],[1,1,null,1,1]],null,[null,null,null,null,null,null,"/images/lockup-new.svg","/images/touchicon-180-new.png",null,null,null,null,1,null,null,null,null,null,null,null,null,1,null,null,null,"/images/lockup-dark-theme-new.svg",[]],[],null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,[6,1,14,15,20,22,23,29,32,36],null,[[null,null,null,[3,7,10,2,39,17,4,32,24,11,12,13,34,15,25],null,null,[1,[["docType","Choose a content type",[["Tutorial",null,null,null,null,null,null,null,null,"Tutorial"],["Guide",null,null,null,null,null,null,null,null,"Guide"],["Sample",null,null,null,null,null,null,null,null,"Sample"]]],["product","Choose a product",[["Android",null,null,null,null,null,null,null,null,"Android"],["ARCore",null,null,null,null,null,null,null,null,"ARCore"],["ChromeOS",null,null,null,null,null,null,null,null,"ChromeOS"],["Firebase",null,null,null,null,null,null,null,null,"Firebase"],["Flutter",null,null,null,null,null,null,null,null,"Flutter"],["Assistant",null,null,null,null,null,null,null,null,"Google Assistant"],["GoogleCloud",null,null,null,null,null,null,null,null,"Google Cloud"],["GoogleMapsPlatform",null,null,null,null,null,null,null,null,"Google Maps Platform"],["GooglePay",null,null,null,null,null,null,null,null,"Google Pay & Google Wallet"],["GooglePlay",null,null,null,null,null,null,null,null,"Google Play"],["Tensorflow",null,null,null,null,null,null,null,null,"TensorFlow"]]],["category","Choose a topic",[["AiAndMachineLearning",null,null,null,null,null,null,null,null,"AI and Machine Learning"],["Data",null,null,null,null,null,null,null,null,"Data"],["Enterprise",null,null,null,null,null,null,null,null,"Enterprise"],["Gaming",null,null,null,null,null,null,null,null,"Gaming"],["Mobile",null,null,null,null,null,null,null,null,"Mobile"],["Web",null,null,null,null,null,null,null,null,"Web"]]]]]],[1,1],null,1],[[["UA-24532603-1"],["UA-22084204-5"],null,null,["UA-24532603-5"],null,null,[["G-272J68FCRF"],null,null,[["G-272J68FCRF",2]]],[["UA-24532603-1",2]],null,[["UA-24532603-5",2]],null,1],[[13,10],[1,1],[11,8],[3,2],[6,5],[12,9],[14,11],[16,13],[4,3],[15,12],[5,4]],[[2,2],[1,1]]],null,4,null,null,null,null,null,null,null,null,null,null,null,null,null,"developers.devsite.google"],null,"pk_live_5170syrHvgGVmSx9sBrnWtA5luvk9BwnVcvIi7HizpwauFG96WedXsuXh790rtij9AmGllqPtMLfhe2RSwD6Pn38V00uBCydV4m"]') </script> <devsite-a11y-announce></devsite-a11y-announce> </body> </html>

CINXE.COM

Google tag API reference | gtag.js | Google for Developers