Actions76
- Data Export API Actions
- Metrics API Actions
- Get Page Activity Rate
- Get Page Bounce Rate
- Get Page Conversion Rate
- Get Page Exit Rate
- Get Page Fold Height
- Get Page Height
- Get Page Interaction Time
- Get Page Landing Rate
- Get Page Scroll Rate
- Get Page Time Spent
- Get Page Unique Visits
- Get Page Views
- Get Page Views per Visit
- Get Page Visits
- Get Page Web Vitals
- Get Site Bounce Rate
- Get Site Cart Average
- Get Site Conversion Rate
- Get Site Conversions
- Get Site Pageview Average
- Get Site Revenue
- Get Site Session Time Average
- Get Site Visits
- Get Zone Attractiveness Rate
- Get Zone Click Rate
- Get Zone Click Recurrence
- Get Zone Conversion Rate per Click
- Get Zone Conversion Rate per Hover
- Get Zone Conversion Rate per Tap
- Get Zone Engagement Rate
- Get Zone Exposure Rate
- Get Zone Exposure Time
- Get Zone Hesitation Time
- Get Zone Hover Rate
- Get Zone Hover Time
- Get Zone Number of Clicks
- Get Zone Revenue
- Get Zone Revenue per Click
- Get Zone Revenue per Tap
- Get Zone Swipe Rate
- Get Zone Swipe Rate Recurrence
- Get Zone Tap Rate
- Get Zone Tap Recurrence
- Get Zone Time Before First Click
- Get Zone Time Before First Tap
- List Goals
- List Mappings
- List Page Groups
- List Page Groups Metrics
- List Segments
- List Site Metrics
- List Zone Metrics
- List Zones
- List Zonings
- Speed Analysis API Actions
Overview
This node integrates with the Contentsquare API to retrieve detailed user behavior and performance metrics related to website zones, pages, and site-wide data. Specifically, the "Get Zone Conversion Rate per Click" operation fetches the percentage of visitors who achieved a specified goal after clicking on a particular zone within a page or app interface.
This node is beneficial for digital analysts and marketers who want to understand how effective specific interactive areas (zones) on their web pages or apps are at driving conversions. For example, it can be used to measure how many users clicked on a promotional banner (zone) and subsequently completed a purchase or signup goal.
Practical examples:
- Measuring conversion effectiveness of call-to-action buttons.
- Analyzing user engagement and conversion rates on different parts of a landing page.
- Optimizing UI elements by comparing conversion rates per click across zones.
Properties
| Name | Meaning |
|---|---|
| Zone ID | The unique identifier of the zone for which the conversion rate per click metric is requested. |
| Query Parameters | A collection of optional filters and settings to refine the query results: - Device: Filter by device type (All, Desktop, Mobile, Tablet). - End Date: End date of analysis range. - Format: Format of the query. - Frequency: Export frequency filter. - From: Export format filter. - Goal ID: Specify a non-ecommerce goal to return conversion metrics for. - IDs: Comma-separated list of segment IDs to filter. - Limit: Maximum number of results to return (default 50). - Metric Type: Choose between Quantile or Average metrics. - Order: Sort order of results (Ascending or Descending). - Page: Page number of results. - Period: Granularity of results (Daily or None). - Project ID: Target project ID (required for account-level API keys). - Quantile: Percentile value used if metric type is Quantile (default 75). - Scope: Filter based on scope. - Segment IDs: Multiple segments separated by commas for intersection filtering. - Start Date: Start date of analysis range. - State: Filter based on status. - To: End date of query date range. |
Output
The output is a JSON array containing the response from the Contentsquare Metrics API endpoint for zone conversion rate per click. The structure typically includes metrics such as:
- Conversion rate percentages per click on the specified zone.
- Breakdown by any applied filters like device type, date ranges, or segments.
- Additional metadata depending on the API response.
If the API returns no content, the node outputs a status message indicating "204 No Content".
The node does not output binary data.
Dependencies
- Requires an API key credential with Client ID, Client Secret, Project ID, and Scope configured in n8n credentials.
- Makes authenticated HTTP requests to the Contentsquare API OAuth token endpoint to obtain an access token.
- Uses the obtained access token to authorize subsequent API calls.
- Requires internet connectivity to reach
https://api.contentsquare.com.
Troubleshooting
- Missing Client ID or Client Secret: The node will throw an error if these credentials are not provided. Ensure that the API credentials are correctly set up in n8n.
- Zone ID is required: For this operation, the Zone ID must be provided; otherwise, an error is thrown.
- Failed to retrieve access token or endpoint: Indicates issues with authentication or API availability. Verify credentials and network connectivity.
- API errors: Any error returned by the Contentsquare API will be wrapped and reported by the node. Check the error message and stack trace for details.
- Empty or malformed responses: If the API returns empty or invalid JSON, the node attempts to handle it gracefully but may output a "204 No Content" status or raw text.