Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Admin (V1Alpha) - Property → Update Property Attribution Settings

AI-generated

Overview

This node integrates with the Google Analytics API, specifically targeting the Admin (V1Alpha) resource for managing properties. The "Update Property Attribution Settings" operation allows users to update attribution settings of a specified Google Analytics property. This is useful for customizing how user interactions and conversions are attributed within your analytics data.

Common scenarios include:

  • Adjusting attribution models to better reflect marketing channel contributions.
  • Updating conversion window settings or other attribution parameters for a property.
  • Automating updates to multiple properties' attribution settings in bulk workflows.

Example: A marketing analyst wants to change the attribution settings of a GA4 property to use a different lookback window for conversions. Using this node operation, they can programmatically update those settings without manual intervention in the Google Analytics UI.

Properties

Name Meaning
Property ID The unique identifier of the Google Analytics property whose attribution settings will be updated.
Query Parameters Optional additional parameters for the request such as updateMask specifying which fields to update.
Request Body JSON object containing the new attribution settings to apply to the property.

Details on input properties relevant to this operation:

  • Property ID: Required string identifying the target property.
  • Query Parameters: Collection of optional query parameters; notably:
    • updateMask: A comma-separated list of field names (in snake_case) indicating which fields in the attribution settings should be updated.
  • Request Body: JSON structure representing the new attribution settings values to patch.

Output

The output is a JSON array where each element corresponds to the response from the Google Analytics API for the update request. The JSON object represents the updated attribution settings of the property after the patch operation.

No binary data is involved in this operation.

Dependencies

  • Requires an OAuth2 credential configured for Google Analytics API access.
  • The node uses the Google Analytics Admin API endpoint https://analyticsadmin.googleapis.com/v1alpha.
  • Proper permissions on the Google Analytics property are necessary to update attribution settings.

Troubleshooting

  • Missing Credentials Error: If the node throws an error about missing credentials, ensure that a valid OAuth2 credential for Google Analytics API is set up and connected.
  • Required Parameter Errors: The node validates presence of required IDs like Property ID. If these are missing, it will throw descriptive errors. Make sure all required inputs are provided.
  • API Errors: Errors returned by the Google Analytics API (e.g., permission denied, invalid update mask) will be surfaced with messages prefixed by "Error calling Google Analytics API". Review the message and stack trace for details.
  • Invalid JSON in Request Body: Ensure the JSON entered in the Request Body field is well-formed and matches the expected schema for attribution settings.

Links and References

This summary focuses on the "Update Property Attribution Settings" operation under 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