Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Admin (V1Alpha) - Property → Create Connected Site Tag

AI-generated

Overview

This node integrates with the Google Analytics API, specifically supporting a wide range of administrative and data-related operations across different versions (v1alpha, v1beta) and resource types. The "Create Connected Site Tag" operation under the "Admin (V1Alpha) - Property" resource allows users to create a connected site tag for a Universal Analytics property. This is useful for linking Universal Analytics properties with Google Analytics 4 properties or managing site tags programmatically.

Common scenarios include:

  • Automating the setup of connected site tags for multiple properties.
  • Managing analytics configurations in bulk via workflows.
  • Integrating Google Analytics administration tasks into broader automation pipelines.

Example use case:

  • A marketing team wants to automatically create connected site tags for new Universal Analytics properties as part of their onboarding process, ensuring consistent tracking setup without manual intervention.

Properties

Name Meaning
Query Parameters Collection of optional query parameters to customize the API request. Includes:
- Calculated Metric ID: ID for calculated metric
- Entity: Level of data access report (property or account)
- Filter: Expression to filter results
- Names: Names of access bindings to retrieve
- Page Size: Max number of report tasks to return
- Page Token: Continuation token for pagination
- Show Deleted: Include soft-deleted ("trashed") properties
- Universal Analytics Property ID: UA property to look up connected GA4 property
- Update Mask: List of fields to update (snake_case)
Request Body JSON object representing the body of the API request. Required for POST/PATCH operations.

Note: For the "Create Connected Site Tag" operation, the main inputs are the requestBody JSON and optionally any relevant query parameters.

Output

The node outputs an array of JSON objects corresponding to the API responses from Google Analytics. Each item in the output array represents the parsed JSON response from the API call made for each input item.

The output JSON structure depends on the specific API endpoint called but generally includes details about the created connected site tag or other resource information.

If binary data were involved (not in this operation), it would be summarized accordingly, but this operation deals with JSON data only.

Dependencies

  • Requires valid Google Analytics API OAuth2 credentials configured in n8n.
  • Uses the Google Analytics Admin API endpoints (https://analyticsadmin.googleapis.com/v1alpha).
  • Network connectivity to Google APIs is 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 selected.
  • Required Parameter Missing: Errors like "Property ID is required" indicate mandatory parameters are not provided. Verify all required IDs (e.g., propertyId) are set.
  • API Call Failures: Errors returned from the Google Analytics API will be wrapped with messages like "Error calling Google Analytics API." Check the error message and stack trace for details.
  • Invalid JSON in Request Body: Ensure the JSON entered in the Request Body field is valid and correctly structured according to the API specification.
  • Permission Issues: Insufficient permissions on the Google Analytics account can cause authorization errors. Confirm the OAuth2 token has the necessary scopes.

Links and References

This summary focuses on the "Create Connected Site Tag" operation within the "Admin (V1Alpha) - Property" resource, describing its purpose, inputs, outputs, dependencies, and common troubleshooting tips based on static analysis of the node's source code and provided property definitions.

Discussion