Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions84

Overview

This node interacts with the Google Analytics API, specifically targeting the Admin (V1Alpha) resource for managing audiences within a property. The "Get Audience" operation retrieves detailed information about a specific audience associated with a given property in Google Analytics.

Common scenarios where this node is beneficial include:

  • Fetching audience details to analyze or use in marketing campaigns.
  • Integrating audience data into workflows for reporting or automation.
  • Managing and auditing audience configurations programmatically.

For example, a marketer might use this node to retrieve an audience's configuration before updating it or to verify audience existence as part of a larger data pipeline.

Properties

Name Meaning
Property ID The unique identifier of the Google Analytics property that contains the audience.
Audience ID The unique identifier of the audience to retrieve.
Query Parameters Optional parameters to refine the request; includes options like calculatedMetricId, entity, filter, names, pageSize, pageToken, showDeleted, universalAnalyticsPropertyId, updateMask.

The "Query Parameters" collection allows adding optional filters and pagination controls to customize the API request.

Output

The node outputs a JSON array containing the response from the Google Analytics API for the requested audience. The structure corresponds directly to the API's audience resource representation, including all relevant audience details such as name, description, membership duration, and other configuration fields.

No binary data output is involved in this operation.

Dependencies

  • Requires a valid Google Analytics API OAuth2 credential configured in n8n.
  • The node makes authenticated HTTP requests to the Google Analytics Admin API endpoint: https://analyticsadmin.googleapis.com/v1alpha.

Troubleshooting

  • Missing Credentials Error: If the Google Analytics API credentials are not set up or invalid, the node will throw an error indicating missing credentials. Ensure that OAuth2 credentials for Google Analytics API are properly configured.
  • Required Parameter Errors: The node requires both "Property ID" and "Audience ID" for the Get Audience operation. Omitting either will cause an error specifying the missing parameter.
  • API Request Failures: Errors returned by the Google Analytics API (e.g., invalid IDs, permission issues) will be surfaced with messages prefixed by "Error calling Google Analytics API". Check the provided IDs and ensure the authenticated user has sufficient permissions.
  • Pagination Issues: When using query parameters like pageSize and pageToken, improper values may lead to incomplete or empty results. Verify these parameters if paginating through large datasets.

Links and References

Discussion