Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Data (V1Alpha) - Property → Run Funnel Report

AI-generated

Overview

This node integrates with the Google Analytics API, specifically supporting a wide range of administrative and data operations across different API versions (v1alpha, v1beta) and resource types. For the selected Resource "Data (V1Alpha) - Property" and Operation "Run Funnel Report," it allows users to run funnel reports on a specified Google Analytics property.

A funnel report helps analyze user journeys through a series of steps (funnels) in your website or app, identifying where users drop off or convert. This is beneficial for marketers, analysts, and product managers aiming to optimize conversion rates and understand user behavior flow.

Practical example:
You can use this node to run a funnel report on a specific property to see how many users progress through stages like "Visited Homepage" → "Added to Cart" → "Completed Purchase," helping identify bottlenecks in the sales process.

Properties

Name Meaning
Property ID The unique identifier of the Google Analytics property on which to run the funnel report.
Query Parameters Optional parameters to customize the request. Includes:
- Calculated Metric ID: ID for a calculated metric to include.
- Entity: Level of data access report (property or account level).
- Filter: Expression to filter results.
- Names: Names of access bindings to retrieve.
- Page Size: Maximum number of report tasks to return (default 10).
- Page Token: Token for fetching next page of results.
- Show Deleted: Whether to include soft-deleted properties (default true).
- Universal Analytics Property ID: UA property to look up connected GA4 property.
- Update Mask: List of fields to update (snake case).
Request Body JSON object containing the body of the funnel report request, specifying funnel steps, dimensions, metrics, date ranges, etc.

Output

The node outputs an array of JSON objects representing the response from the Google Analytics API's funnel report endpoint. The structure corresponds directly to the API's funnel report response, typically including:

  • Funnel steps and their counts.
  • Conversion rates between steps.
  • Breakdown by dimensions if requested.
  • Metadata about the report.

No binary data output is involved.

Dependencies

  • Requires valid Google Analytics OAuth2 credentials configured in n8n.
  • Uses the Google Analytics Data API endpoint https://analyticsdata.googleapis.com/v1alpha.
  • The node dynamically constructs the API URL based on the selected resource and operation.
  • Proper permissions on the Google Analytics property are required to run funnel reports.

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: The node validates presence of required IDs such as Property ID. Missing these will cause errors like "Property ID is required."
  • API Errors: Errors returned from the Google Analytics API are wrapped and shown with message "Error calling Google Analytics API: ...". Check the error details for issues like permission denied, invalid parameters, or quota exceeded.
  • Pagination Issues: When using query parameters like pageToken, ensure correct tokens are used to paginate through large result sets.
  • JSON Body Format: The request body must be valid JSON matching the expected schema for funnel reports; malformed JSON will cause request failures.

Links and References

This summary focuses on the "Data (V1Alpha) - Property" resource and the "Run Funnel Report" operation, describing the node's input properties, output, dependencies, and common troubleshooting points based on static analysis of the provided source code and property definitions.

Discussion