Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Data (V1Beta) - Audience Export → Create Audience Export

AI-generated

Overview

This node integrates with the Google Analytics API, specifically supporting a wide range of administrative and data-related operations across different API versions (v1alpha, v1beta) and resources. For the Data (V1Beta) - Audience Export resource, the node enables creating, retrieving, listing, and querying audience exports within a Google Analytics property.

The Create Audience Export operation allows users to initiate an export of audience data from a specified property. This is useful for marketers or analysts who want to extract audience segments for further analysis, integration with other marketing platforms, or reporting purposes.

Practical examples:

  • Exporting a specific audience segment from your Google Analytics property to use in external advertising platforms.
  • Automating the extraction of audience data for offline analysis or integration into CRM systems.
  • Scheduling recurring exports of audience data for regular reporting.

Properties

Name Meaning
Property ID The identifier of the Google Analytics property where the audience export will be created.
Query Parameters Optional parameters to customize the request, such as filtering, pagination, or specifying entities. Options include:
- Calculated Metric ID
- Entity (property or account level)
- Filter expression
- Names of access bindings
- Page Size (max number of results)
- Page Token (for pagination)
- Show Deleted (include soft-deleted properties)
- Universal Analytics Property ID
- Update Mask (fields to update)
Request Body JSON object containing the details of the audience export to create. This should conform to the API's expected schema for audience exports.

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 Export operation, the output JSON contains the details of the newly created audience export resource, including identifiers, status, and metadata as returned by the Google Analytics API.

If the operation involves binary data (not typical for this resource), it would be summarized accordingly, but this node primarily deals with JSON responses.

Dependencies

  • Requires valid Google Analytics API OAuth2 credentials configured in n8n.
  • The node uses the Google Analytics Data API endpoints:
    • Base URL for Data (V1Beta) resources: https://analyticsdata.googleapis.com/v1beta
  • Proper permissions on the Google Analytics property to manage audience exports are necessary.

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" or "Audience Export 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 rate limits, permission issues, or invalid request bodies. Check the error message for details and verify API quotas and permissions.
  • Invalid JSON in Request Body: Ensure that the JSON provided in the Request Body field is correctly formatted and matches the expected schema for the audience export creation.

Links and References

This summary focuses on the Data (V1Beta) - Audience Export resource and the Create Audience Export operation as requested, based on static analysis of the node's source code and provided property definitions.

Discussion