Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Data (V1Alpha) - Audience List → Create Audience List

AI-generated

Overview

This node integrates with the Google Analytics API, specifically supporting a wide range of administrative and data operations across different versions (v1alpha, v1beta) and resource types. For the Data (V1Alpha) - Audience List resource, the node enables management of audience lists within a property, including creating new audience lists.

The Create Audience List operation allows users to create an audience list in a specified Google Analytics property. This is useful for marketers and analysts who want to segment their user base for targeted campaigns or analysis.

Practical example:
A marketing team wants to create a new audience list based on specific user behavior tracked in their Google Analytics property. Using this node, they can programmatically create that audience list by specifying the property ID and the audience details in the request body, automating audience management workflows.

Properties

Name Meaning
Property ID The identifier of the Google Analytics property where the audience list will be created.
Query Parameters Optional parameters to filter or modify the request; includes options like calculatedMetricId, entity, filter, names, pageSize, pageToken, showDeleted, universalAnalyticsPropertyId, updateMask.
Request Body JSON object containing the details of the audience list to create, such as name, description, and membership criteria.

Output

The node outputs a JSON array where each element corresponds to the response from the Google Analytics API for the executed operation. For the Create Audience List operation, the output JSON contains the newly created audience list's details as returned by the API, including its unique identifiers and configuration.

No binary data output is involved in this operation.

Dependencies

  • Requires an OAuth2 credential configured for Google Analytics API access.
  • The node uses the Google Analytics Data API endpoints:
    • Base URL for Data (V1Alpha) resources: https://analyticsdata.googleapis.com/v1alpha
  • Proper permissions on the Google Analytics property are required to create audience lists.

Troubleshooting

  • Missing Credentials Error:
    If the node throws "Missing Google Analytics API Credentials," ensure that the OAuth2 credentials for Google Analytics API are properly set up and connected in n8n.

  • Required Parameter Errors:
    Errors like "Property ID is required" or "Audience List ID is required" indicate missing mandatory inputs. Verify that all required fields are provided.

  • API Request Failures:
    Errors returned from the Google Analytics API may include permission issues, invalid request bodies, or quota limits. Check the error message for details and verify API access rights and request correctness.

  • JSON Parsing Errors:
    Ensure that the JSON provided in the Request Body field is valid and correctly formatted.

Links and References

Discussion