Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Data (V1Alpha) - Recurring Audience List → Create Recurring Audience List

AI-generated

Overview

This node integrates with the Google Analytics API, specifically supporting the creation of recurring audience lists within a property. It allows users to automate the management of audience segments that update on a recurring basis, which is useful for marketing and analytics workflows where audiences need to be refreshed regularly.

A common scenario for this node is when a marketer wants to maintain an up-to-date audience list based on specific criteria (e.g., user behavior or demographics) and use it for targeted advertising campaigns or analysis. For example, creating a recurring audience list that updates weekly with users who visited a particular product page.

Properties

Name Meaning
Property ID The identifier of the Google Analytics property under which the recurring audience list is managed. This is required to specify the scope of the operation.
Query Parameters Optional parameters to customize the request, such as filtering, pagination, or specifying calculated metric IDs. These include:
- Calculated Metric ID
- Entity (property or account level)
- Filter expression
- Names of access bindings
- Page Size (number of results)
- Page Token (for pagination)
- Show Deleted (boolean to include soft-deleted properties)
- Universal Analytics Property ID
- Update Mask (fields to update)
Request Body JSON object containing the details of the recurring audience list to create. This includes all necessary configuration for the audience list definition.

Output

The output is a JSON array containing the response from the Google Analytics API after creating the recurring audience list. The structure corresponds to the API's representation of a recurring audience list resource, typically including fields such as:

  • The unique ID of the created recurring audience list.
  • Configuration details of the audience list.
  • Metadata about creation time, update time, and status.

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 Data API endpoints.
  • Proper permissions on the Google Analytics property are necessary to create recurring audience lists.

Troubleshooting

  • Missing Credentials Error: If the node throws "Missing Google Analytics API Credentials," ensure that the 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 specified.
  • API Request Failures: Errors returned from the Google Analytics API will be surfaced with messages prefixed by "Error calling Google Analytics API." Check the error message and stack trace for details. Common issues include insufficient permissions, invalid request body format, or incorrect parameter values.
  • Pagination Issues: When using query parameters for listing or querying, ensure correct handling of pageToken and pageSize to avoid incomplete data retrieval.

Links and References

This summary is based solely on static analysis of the provided source code and property definitions without runtime execution.

Discussion