Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Admin (V1Beta) - Custom Dimension → Create Custom Dimension

AI-generated

Overview

This node integrates with the Google Analytics API, specifically targeting the Admin (V1Beta) resource for managing Custom Dimensions within a property. The "Create Custom Dimension" operation allows users to create new custom dimensions in a specified Google Analytics property.

Common scenarios where this node is beneficial include:

  • Automating the creation of custom dimensions for tracking specific user interactions or attributes not covered by default dimensions.
  • Integrating Google Analytics configuration changes into automated workflows.
  • Managing analytics properties programmatically without manual intervention in the Google Analytics UI.

For example, a marketing team could use this node to automatically add custom dimensions for campaign tracking whenever a new campaign is launched, ensuring consistent data collection across properties.

Properties

Name Meaning
Property ID The identifier of the Google Analytics property where the custom dimension will be created.
Query Parameters Optional additional parameters to customize the request, such as filters or pagination options. Possible keys include: Calculated Metric ID, Entity, Filter, Names, Page Size, Page Token, Show Deleted, Universal Analytics Property ID, Update Mask.
Request Body JSON object containing the details of the custom dimension to create, including its configuration and attributes.

Output

The node outputs a JSON array where each element corresponds to the response from the Google Analytics API for the create custom dimension request. The JSON structure represents the newly created custom dimension resource, including its unique identifiers and configuration details as returned by the API.

No binary data output is involved in this operation.

Dependencies

  • Requires an OAuth2 API credential configured for Google Analytics access.
  • The node uses the Google Analytics Admin API endpoint https://analyticsadmin.googleapis.com/v1beta.
  • Proper permissions on the Google Analytics property are necessary to create custom dimensions.

Troubleshooting

  • Missing Credentials Error: If the node throws an error about missing credentials, ensure that a valid Google Analytics OAuth2 credential is configured and selected.
  • Required Parameter Errors: The node requires the Property ID and a properly formatted request body. Missing these will cause errors indicating which parameter is required.
  • API Errors: Errors returned from the Google Analytics API (e.g., permission denied, invalid request body) will be surfaced with messages prefixed by "Error calling Google Analytics API". Review the message and stack trace for details.
  • JSON Formatting: Ensure the Request Body JSON is correctly formatted; invalid JSON will cause parsing errors.

Links and References


This summary is based on static analysis of the node's source code and provided property definitions, focusing on the "Admin (V1Beta) - Custom Dimension" resource and the "Create Custom Dimension" operation.

Discussion