docs(analytics): Sync changes from firebase.google.com (#9024)

Author: kevinthecheung

docs/analytics/_events.md

@@ -22,20 +22,20 @@ events with the library's `log`- methods.
 ### Predefined events
 
 To help you get started, the Analytics SDK defines a number of
-suggested events that are common among different types of apps, including
+recommended events that are common among different types of apps, including
 retail and ecommerce, travel, and gaming apps. To learn more
 [about these events](https://support.google.com/analytics/answer/9322688)
 and when to use them, browse the
 [Events and properties](https://support.google.com/firebase/topic/6317484)
 articles in the Firebase Help Center.
 
-Note: To get the maximum detail in reports, log the suggested events that make
+Note: To get the maximum detail in reports, log the recommended events that make
 sense for your app and their prescribed parameters. This also ensures that you
 benefit from the latest Google Analytics features as
 they become available.
 
 
-You can find the log methods for the suggested event types in the
+You can find the log methods for the recommended event types in the
 [API reference](https://pub.dev/documentation/firebase_analytics/latest/firebase_analytics/FirebaseAnalytics-class.html).
 
 The following example demonstrates how to log a `select_content` event:
@@ -87,7 +87,7 @@ to any event:
 
 ### Custom events
 
-If your application has specific needs not covered by a suggested
+If your application has specific needs not covered by a recommended
 event type, you can log your own custom events as shown in this example:
 
 ```dart

docs/analytics/_user-properties.md

@@ -1,30 +1,30 @@
 {# This content gets published to the following location:                        #}
 {#   https://firebase.google.com/docs/analytics/user-properties?platform=flutter #}
 
-{# TODO(markarndt): Sync all this content up with Analytics content consolidation plan. #}
+{# TODO(markarndt): Sync all this content up with Analytics content
+consolidation plan. #}
 
 ## Before you begin
 
-Make sure that you've set up your project and can access Analytics as
-described in [Get Started with Analytics](get-started).
+Make sure that you've set up your project and can access {{analytics}} as
+described in [Get Started with {{analytics}}](get-started).
 
 ## Set user properties
 
-You can set Analytics User Properties to describe the users of your app.
-You can analyze behaviors of various user segments by applying these
-properties as filters to your reports.
+You can set {{ analytics }} user properties to describe the users of your app.
+You can make use of user properties by creating custom definitions, then using
+them to apply comparisons in your reports or as audience evaluation criteria.
 
-Set a user property as follows:
+To set a user property, follow these steps:
 
-1. Register the property in the [** User Properties ** page](https://console.firebase.google.com/project/_/analytics/userproperty)
-   of Analytics in the Firebase console. For more information, see
-   [Set and register a user property](//support.google.com/firebase/answer/6317519?ref_topic=6317489#create-property).
-1. Add code to set an Analytics User Property with the `setUserProperty()`
-   method.
+1. Create a custom definition for the user property in the
+  [**Custom Definitions** page](https://console.firebase.google.com/project/_/analytics/userproperty){: .external}
+  of _{{analytics}}_ in the {{name_appmanager}}. For more information, see
+  [Custom dimensions and metrics](//support.google.com/firebase/answer/6317519).
+1. Set a user property in your app with the `setUserProperty()` method.
 
-The following example
-adds a hypothetical favorite food property, which assigns the value in
-`favoriteFood` to the active user:
+The following example adds a hypothetical favorite food property, which
+assigns the value in `favoriteFood` to the active user:
 
 ```dart
 await FirebaseAnalytics.instance