Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Admin (V1Alpha) - Subproperty Event Filter → Update Subproperty Event Filter

AI-generated

Overview

This node integrates with the Google Analytics API, specifically supporting a wide range of administrative and data management operations. The "Update Subproperty Event Filter" operation under the "Admin (V1Alpha) - Subproperty Event Filter" resource allows users to update an existing subproperty event filter within a specified property.

Use cases include managing event filters that control which events are included or excluded in analytics data for subproperties of a Google Analytics property. This is useful for refining data collection and reporting by filtering out unwanted events or focusing on specific event subsets.

For example, you might use this operation to modify the criteria of an event filter to exclude certain internal traffic events from your analytics reports or to adjust event parameters for better segmentation.

Properties

Name Meaning
Property ID The identifier of the Google Analytics property where the subproperty event filter exists.
Subproperty Event Filter ID The identifier of the specific subproperty event filter to update.
Query Parameters Optional 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: Token for fetching next page of results.
- 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 update (in snake case).
Request Body JSON object containing the updated details of the subproperty event filter.

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 subproperty event filter resource as returned by the API.

No binary data output is involved in this operation.

Dependencies

  • Requires valid Google Analytics API OAuth2 credentials configured in n8n.
  • The node makes authenticated HTTP requests to the Google Analytics Admin API endpoint (https://analyticsadmin.googleapis.com/v1alpha).
  • Proper permissions on the Google Analytics property are necessary to perform update operations on subproperty event filters.

Troubleshooting

  • Missing Credentials Error: If the node throws an error about missing credentials, ensure that the Google Analytics OAuth2 API credentials are properly set up and linked in n8n.
  • Required Parameter Missing: Errors indicating missing Property ID or Subproperty Event Filter ID mean these must be provided for the update operation.
  • API Errors: Any errors returned by the Google Analytics API will be surfaced with messages prefixed by "Error calling Google Analytics API". Check the message and stack trace for details.
  • Invalid JSON in Request Body: Ensure the JSON provided in the Request Body field is well-formed and matches the expected schema for a subproperty event filter update.

Links and References

Discussion