Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

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

AI-generated

Overview

This node integrates with the Google Analytics API, specifically targeting the Admin (V1Alpha) resource for managing Subproperty Event Filters. The "Create Subproperty Event Filter" operation allows users to create event filters that apply to subproperties within a Google Analytics property. This is useful for organizations that want to filter or segment event data at a more granular level within their analytics properties.

Common scenarios include:

  • Creating filters to exclude internal traffic or specific event types from subproperty data.
  • Defining event filters to customize data collection and reporting for different subproperties.
  • Automating the management of event filters across multiple subproperties in an analytics account.

Example: A marketing team wants to create an event filter on a subproperty to exclude test events generated during QA testing, ensuring clean data for analysis.

Properties

Name Meaning
Property ID The unique identifier of the Google Analytics property where the subproperty event filter will be created.
Query Parameters Optional parameters to refine or control the request, such as filtering results or pagination options. Includes: Calculated Metric ID, Entity, Filter expression, Names, Page Size, Page Token, Show Deleted flag, Universal Analytics Property ID, Update Mask.
Request Body JSON object containing the details of the subproperty event filter to create. This includes the configuration of the filter itself according to Google Analytics API specifications.

Output

The output is a JSON array containing the response from the Google Analytics API after creating the subproperty event filter. The structure corresponds to the API's representation of a subproperty event filter resource, typically including fields like the filter's ID, name, filter criteria, and status.

No binary data output is involved.

Dependencies

  • Requires valid Google Analytics API OAuth2 credentials configured in n8n.
  • The node uses the Google Analytics Admin API v1alpha endpoint (https://analyticsadmin.googleapis.com/v1alpha).
  • Proper permissions on the Google Analytics account and property are necessary to create subproperty event filters.

Troubleshooting

  • Missing Credentials Error: If the node throws "Missing Google Analytics API Credentials," ensure that OAuth2 credentials for Google Analytics are properly set up and connected.
  • Required Parameter Errors: Errors like "Property ID is required" indicate that mandatory input parameters were not provided. Verify that the Property ID and other required IDs are correctly set.
  • API Errors: Errors returned by the Google Analytics API may include permission issues, invalid request body format, or exceeding quota limits. Review the error message and stack trace for details.
  • JSON Parsing Errors: Ensure that the Request Body JSON is well-formed and matches the expected schema for a subproperty event filter.

Links and References

This summary is based on static analysis of the node's source code and provided property definitions, focusing on the "Create Subproperty Event Filter" operation under the Admin (V1Alpha) resource.

Discussion