[null,null,["最后更新时间 (UTC):2024-02-06。"],[[["\u003cp\u003eGoogle recommends using gtag.js or Google Tag Manager for the latest measurement product functionality.\u003c/p\u003e\n"],["\u003cp\u003eLegacy tag platforms can be upgraded to gtag.js or Google Tag Manager with product-specific guidance.\u003c/p\u003e\n"],["\u003cp\u003eConsolidating to a single tag platform, ideally gtag.js or Google Tag Manager, is recommended for optimal data collection and management.\u003c/p\u003e\n"],["\u003cp\u003eUsers of gtag.js are mostly up-to-date but may need to update instrumentation for cross-product event definitions; Google Tag Manager users should check and update tag versions as needed.\u003c/p\u003e\n"],["\u003cp\u003eThird-party TMS users should ensure their system utilizes the latest Google tag platform version and update if necessary.\u003c/p\u003e\n"]]],["Google suggests deploying measurement tags via gtag.js or Google Tag Manager for the latest functionality. Legacy tags like conversions.js and analytics.js can be upgraded. Users should analyze existing tags and update instrumentation to use common event definitions. Google Tag Manager users can upgrade tags with a few clicks, configuring triggers and publishing changes. Legacy and third-party tag systems should also be upgraded or updated. Consider consolidating to a single tag platform.\n"],null,["# Upgrade guide\n\n| **Dogfood:** [Edit or comment on this draft in Google Docs](https://docs.google.com/document/d/1FaUGYDaE8ofv7gM4f-t2CzT5ABicKO4uFaYi7EuKYP8/edit)\n\n**TODO:** *This will be the upgrade guide based on this [sheet](https://docs.google.com/spreadsheets/d/1BTWbYEtBm1QeMZnCpHQUe3NFFFYRmu5iuo0hVtDwN04/edit#gid=0)*.\n\nTo get the latest functionality from Google measurement products as they become available, Google recommends that you deploy measurement tags via gtag.js or Google Tag Manager.\n\nLegacy tag platforms such as conversions.js and analytics.js can upgrade to gtag.js or Google Tag Manager. To make sure your upgrade process goes as smoothly as possible, consult guidance for each specific product.\n\nNot sure what tag platform you currently use? [Read our guide on how to analyze existing tags](/tag-platform/devguides/existing)!\n\nIf you use gtag.js\n------------------\n\nIn most cases you are using the latest tag library. Good job! In some cases you may need to update your instrumentation to use common event definitions that work across your products and interoperate with the latest reports.\n\nIf you use Google Tag Manager\n-----------------------------\n\nCheck to see which versions of tags you have deployed with Google Tag Manager. If you are using an older tag platform (e.g. Universal Analytics) you can upgradce to a more advanced version with a few simple clicks. Simply add the updated version of your tag, apply appropriate trigger conditions for your tag, configure instrumentation (such as ecommerce), and publish your container for the changes to take effect.\n| **Note:** You can run older tags alongside more modern tags at the same time. Data is routed accordingly and you can compare legacy reports to the latest report types as they become available.\n\nIf you use legacy tag types\n---------------------------\n\nIf you have legacy tag types installed, such as ga.js, analytics.js, or conversion.js, you should consider an upgrade to gtag.js or Google Tag Manager.\n\nIf you use a third-party Tag Management System\n----------------------------------------------\n\nIf you use a third-party tag management system (TMS), check to see if the TMS uses the latest version of Google's tag platform. If not, you may need to update your tag template or custom code to get the latest functionality.\n\nIf you use a mix of tag platforms\n---------------------------------\n\nWe know how it is. In the real world, as sites and apps grow and change management, tag technologies have a way of evolving.\n\nOptimally, your site will use one single tag platform. Consider consolidating your tags to the single platform if possible. This will help reduce errors in data collection, improve performance, minimize the chance of bugs appearing, and simplify ongoing management."]]