Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.marcenta.ai/llms.txt

Use this file to discover all available pages before exploring further.

Queries is an interactive data explorer that lets you ask questions about your marketing data without writing code. You can compose a query by selecting a source system, metrics, dimensions, and filters, and Marcenta returns the results as a table and chart. You can also type a question in plain language and the AI will interpret it, run the query, and explain what it found—all in the same interface. Select Queries in the left sidebar. The interface is split into a conversation area on the right and a conversations sidebar on the left, where previous query sessions are saved for you to revisit.

Run a structured query

1

Open the query composer

Select the input area at the bottom of the Queries page to open the composer.
2

Select a source system

Choose the data source you want to query. The available source systems are:
  • Google Ads (google_ads)
  • Google Analytics 4 (ga4)
  • Google Search Console (gsc)
  • LinkedIn Ads (linkedin_ads)
  • HubSpot (hubspot)
3

Choose metrics and dimensions

Select one or more metrics and the dimensions you want to group by. The available options update based on your selected source and the data Marcenta has ingested.
4

Set the date range

Pick a start and end date for the query. You can also add filters to narrow results to a specific campaign, country, device, or any other available dimension.
5

Run the query

Submit the query. Results appear as a data table and, where applicable, as a chart.

Available metrics

The metrics available depend on the source system you select. Common metrics across sources include:
  • impressions — total ad or search impressions
  • clicks — total clicks
  • ctr_pct — click-through rate as a percentage
  • conversions — total conversion events
  • spend — total ad spend
  • cpc — cost per click

Available dimensions

Dimensions let you group and slice your data. Common dimensions include:
DimensionDescription
dateDay-level time series
campaignCampaign name
channel_groupHigh-level channel grouping (e.g., Paid Search, Organic)
sourceTraffic source
mediumTraffic medium
ad_groupAd group name (Google Ads, LinkedIn Ads)
keywordKeyword term (Google Ads, Google Search Console)
countryCountry of the user or target
regionSub-national region
cityCity
landing_pageLanding page URL
deviceDevice category (desktop, mobile, tablet)
Additional dimensions available for LinkedIn Ads include job_function, job_title, seniority, company_size, and industry.

Add filters

Filters let you narrow a query before it runs. Each filter consists of a dimension field, an operator (equals, not equals, contains, greater than, etc.), and a value. You can add multiple filters and combine them with AND or OR logic.
Filters run at query time, so they reduce the dataset before Marcenta aggregates results. This makes filtered queries faster and more focused than filtering a large result set afterward.

Use natural language

Instead of composing a query manually, you can type a question directly into the input area. For example:
  • “Show me clicks and impressions by campaign for the last 30 days from Google Ads”
  • “What were my top 5 landing pages by sessions last month?”
  • “Compare conversion rates by device for LinkedIn Ads this quarter”
Marcenta interprets your question, constructs the query, and returns the results with a text explanation of what it found.

AI Insights

After any query runs, you can select AI Insights to get a written analysis of the results. The AI looks at patterns in the data—trends, outliers, top performers, underperformers—and summarizes them in plain language. You can ask follow-up questions in the same conversation to dig deeper.
AI Insights works on the result data that Marcenta already retrieved. It does not re-run the query; it analyzes the rows already returned. For very large result sets, Marcenta analyzes up to 500 rows.

Save and revisit queries

Every query session is saved automatically as a conversation in the left sidebar. Select any past conversation to reload the context and continue where you left off, or start a new session from the top of the sidebar.

Export query results

To use query results outside of Marcenta, copy the data from the results table or use the export option where available.