Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Admin (V1Beta) - Key Event → Update Key Event

AI-generated

Overview

This node integrates with the Google Analytics API, specifically supporting the "Admin (V1Beta) - Key Event" resource and its operations. The "Update Key Event" operation allows users to update an existing key event within a specified Google Analytics property. This is useful for managing important events that are tracked in Google Analytics, enabling updates to their configuration or metadata.

Typical use cases include:

  • Modifying details of a key event after it has been created.
  • Automating updates to key events as part of a larger analytics workflow.
  • Synchronizing event configurations from external systems into Google Analytics.

For example, you might update the parameters or descriptions of a key event to reflect changes in your tracking strategy without manually editing them in the Google Analytics UI.

Properties

Name Meaning
Property ID The identifier of the Google Analytics property where the key event exists.
Key Event ID The unique identifier of the key event to update.
Query Parameters Optional query parameters to customize the request, including:
- Calculated Metric ID: ID for a calculated metric.
- Entity: Level of data access report (property or account).
- Filter: Expression to filter results.
- Names: Names of access bindings to retrieve.
- Page Size: Maximum number of report tasks to return.
- Page Token: Continuation token for pagination.
- Show Deleted: Whether to include soft-deleted properties.
- Universal Analytics Property ID: UA property to look up connected GA4 property.
- Update Mask: List of fields to be updated (in snake case).
Request Body JSON object containing the updated data for the key event.

Output

The node outputs a JSON array where each element corresponds to the response from the Google Analytics API for the update operation. The JSON structure reflects the updated key event resource as returned by the API, typically including fields such as the key event's ID, name, parameters, and other metadata.

No binary data output is involved.

Dependencies

  • Requires valid Google Analytics API credentials configured in n8n (an OAuth2 credential with appropriate scopes).
  • The node makes authenticated HTTP requests to the Google Analytics Admin API endpoint https://analyticsadmin.googleapis.com/v1beta.

Troubleshooting

  • Missing Credentials Error: If the node throws "Missing Google Analytics API Credentials," ensure that the Google Analytics OAuth2 credentials are properly set up and selected.
  • Required Parameter Errors: Errors like "Property ID is required" or "Key Event ID is required" indicate missing mandatory inputs. Verify that these IDs are correctly provided.
  • API Errors: Errors returned from the Google Analytics API will be wrapped and shown with the message prefix "Error calling Google Analytics API." Check the error message and stack trace for details.
  • Invalid JSON in Request Body: Ensure the JSON provided in the Request Body field is valid and matches the expected schema for updating a key event.

Links and References

Discussion