Google Analytics icon

Google Analytics

Use the Google Analytics API

Actions236

Admin (V1Beta) - Google Ads Link → Create Google Ads Link

AI-generated

Overview

This node integrates with the Google Analytics API, specifically targeting the Admin (V1Beta) resource for managing Google Ads Links. The "Create Google Ads Link" operation allows users to create a new link between a Google Analytics property and a Google Ads account. This is useful for marketers and analysts who want to connect their Google Analytics data with Google Ads campaigns to enable better tracking, reporting, and optimization of advertising efforts.

Typical use cases include:

  • Linking a Google Analytics property to a Google Ads account to import conversions and audiences.
  • Automating the creation of Google Ads links as part of a larger workflow that manages analytics properties.
  • Streamlining account setup by programmatically managing Google Ads integrations.

Properties

Name Meaning
Property ID The identifier of the Google Analytics property where the Google Ads link will be created.
Query Parameters Optional parameters to customize the API request; includes filters, pagination, etc.
Request Body JSON object containing the details of the Google Ads link to create (e.g., ads accounts).

Details on Properties:

  • Property ID: Required string specifying the target Google Analytics property.
  • Query Parameters: A collection of optional parameters such as filter, pageSize, pageToken, etc., to refine the API call.
  • Request Body: A JSON structure representing the Google Ads link configuration to be created. This typically includes the Google Ads customer ID and any relevant settings.

Output

The node outputs a JSON array where each element corresponds to the response from the Google Analytics API for the create operation. The output JSON contains the details of the newly created Google Ads link, including identifiers and status information.

No binary data output 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/v1beta.
  • Proper permissions are needed on the Google Analytics property and Google Ads account to create links.

Troubleshooting

  • Missing Credentials Error: If the node throws an error about missing credentials, ensure that a valid OAuth2 credential for Google Analytics API is configured in n8n.
  • Required Parameter Errors: The node validates required parameters like Property ID and will throw errors if they are missing. Make sure these are provided.
  • API Permission Issues: Insufficient permissions on the Google Analytics property or Google Ads account can cause API errors. Verify that the authenticated user has the necessary roles.
  • Malformed Request Body: The Request Body must be valid JSON and conform to the expected schema for creating a Google Ads link. Invalid JSON or missing required fields will cause API errors.
  • Network or API Errors: General API errors will be reported with messages prefixed by "Error calling Google Analytics API". Check the message and stack trace for details.

Links and References


This summary is based on static analysis of the node's source code and input property definitions for the "Create Google Ads Link" operation under the Admin (V1Beta) Google Ads Link resource.

Discussion