Adding these events to your website or mobile app helps you measure additional features and behavior as well as generate more useful reports. Because these events require additional context to be meaningful, they're not sent automatically.
Use the links in this article to see the prescribed parameters for each event. You should send recommended events with their prescribed parameters to get the most details in your reports and to benefit from future features and integrations as they become available.
To learn how to set up a recommended event on your website, see Set up events. For your app project, see Log events. The data from these events automatically update predefined dimensions and metrics so you can analyze the data in your reports.
For subtitles in your language, turn on YouTube captions. Select the settings icon at the bottom of the video player, then select "Subtitles/CC" and choose your language.
For all properties
We recommend these events to all customers in all business verticals. Later sections in this article include some of these events when we recommend sending the events for the given use case.
| Event | Trigger when a user... |
|---|---|
| ad_impression | sees an advertisement, for apps only |
| earn_virtual_currency | earns virtual currency (coins, gems, tokens, etc.) |
| generate_lead | submits a form or a request for information |
| join_group | joins a group |
| login | logs in |
| purchase | completes a purchase |
| refund | receives a refund |
| search | searches your website or app |
| select_content | selects content on your website or app |
| share | shares content from your website or app |
| sign_up | signs up for an account on your website or app |
| spend_virtual_currency | spends virtual currency (coins, gems, tokens, etc.) |
| tutorial_begin | begins a tutorial during an on-boarding process |
| tutorial_complete | completes a tutorial during an on-boarding process |
For online sales
We recommend these events when you want to measure sales on your site or app. They're useful for retail, ecommerce, education, real estate, and travel. Sending the events populates the Ecommerce purchases report. To learn more about these events, see Measure ecommerce for your website. View Measure ecommerce (app) for events in your app project.
| Event | Trigger when a user... |
|---|---|
| add_payment_info | submits their payment information during checkout |
| add_shipping_info | submits their shipping information during checkout |
| add_to_cart | adds items to their shopping cart |
| add_to_wishlist | adds items to their wishlist |
| begin_checkout | begins checkout |
| purchase | completes a purchase |
| refund | receives a refund |
| remove_from_cart | removes items from their shopping cart |
| select_item | selects an item from a list of items or offerings |
| select_promotion | selects a promotion |
| view_cart | views their shopping cart |
| view_item | views an item |
| view_item_list | views a list of items or offerings |
| view_promotion | views a promotion on your website or app |
For lead generation
We recommend these events when you want to measure the full lead generation funnel for online and offline activity. They're useful for business-to-business sales, automotive sales, insurance sales, or generally for when conversions occur offline.
| Event | Trigger when a user... |
| generate_lead | submits a form online or submits information offline |
| qualify_lead | is marked as fitting the criteria to become a qualified lead |
| disqualify_lead | is marked as disqualified to become a lead for one of several reasons |
| working_lead | contacts or is contacted by a representative |
| close_convert_lead | became a converted lead (a customer) |
| close_unconvert_lead | is marked as not becoming a converted lead for one of several reasons |
For games
We recommend these events for games properties. Sending these events populates the games reports.
| Event | Trigger when a user... |
|---|---|
| earn_virtual_currency | earns virtual currency (coins, gems, tokens, etc.) |
| join_group | joins a group |
| level_end | completes a level in a game |
| level_start | starts a new level in a game |
| level_up | levels-up in the game |
| post_score | posts their score |
| select_content | selects content |
| spend_virtual_currency | spends virtual currency (coins, gems, tokens, etc.) |
| tutorial_begin | begins a tutorial during an on-boarding process |
| tutorial_complete | completes a tutorial during an on-boarding process |
| unlock_achievement | unlocks an achievement |
Verify your events
Monitor recommended events after setup using the DebugView tool. You can also view the Realtime report to see events coming in from real users as the events are triggered.
Event recommendations in Analytics
The Events report provides recommendations on events to collect based on the data you already collect or the app category in the Google Play Store or iOS App Store (e.g., ecommerce, travel). Three recommendations appear at the top of the Events table by default.
- To see more recommendations, click Show All.
- To display the code snippet to collect an event, click the row for the event.
- To dismiss a recommendation, hover over the event name and then click
.
Considerations for updating SDKs to Android 17.2.5 (or later) and/or iOS: 16.20.0 (or later)
If you used prior versions of either SDK and are planning to upgrade to Android 17.2.5 (or later) and/or iOS 16.20.0 (or later), you should consider the following:
- Upon upgrade and from that point forward, you will only be able to access item data within the repeated items array; item data will no longer be available in standard event parameters as it has been prior to these SDK versions.
- This change was made to support multiple-product analysis.
- You may need to adjust your references to item/product data as a result.
There is a BigQuery schema format change during this upgrade. Item/product data will begin to appear in a repeated field, enabling analysis of multiple products within a single event. You should take care to adjust any query that references item/product data fields during this upgrade