Marvyn

Ad-level (creative) results for Meta and Google ads in a period, compared with the period before: spend, impressions, clicks, CTR, cost per click, conversions and cost per conversion, plus Meta's own creative-fatigue rating where Meta provides one. Use it to find tired or winning ads. Read-only. Every result has a `reliability` object. Present only numbers that are present; a null metric was withheld because there was not enough data, so say that rather than estimating it. If status is "limited", mention the listed missing sources, stale data or small samples. If status is "insufficient", say Marvyn does not have enough data to answer. If sampleData is true, the numbers are Marvyn demo data, not the user's business.

get_creative_performance

Campaign-level results from the user's connected ad accounts (Meta, Google, LinkedIn, Snapchat, Reddit) for a period, compared with the period before: spend, impressions, clicks, conversions, revenue, ROAS, cost per conversion and click-through rate. Filter by platform; sort by spend or conversions. Use it to find what is working or wasting money. Read-only. Every result has a `reliability` object. Present only numbers that are present; a null metric was withheld because there was not enough data, so say that rather than estimating it. If status is "limited", mention the listed missing sources, stale data or small samples. If status is "insufficient", say Marvyn does not have enough data to answer. If sampleData is true, the numbers are Marvyn demo data, not the user's business.

get_campaign_performance

The user's funnel for a period: ad impressions, ad clicks, website sessions, engaged sessions, website conversions and store orders, with the rate at each step, and Marvyn's diagnosis of the biggest bottleneck (acquisition, conversion, measurement or efficiency) with its evidence and confidence. Read-only. Every result has a `reliability` object. Present only numbers that are present; a null metric was withheld because there was not enough data, so say that rather than estimating it. If status is "limited", mention the listed missing sources, stale data or small samples. If status is "insufficient", say Marvyn does not have enough data to answer. If sampleData is true, the numbers are Marvyn demo data, not the user's business.

get_conversion_funnel

Investigates why something changed or is not working in the user's marketing ("why are sales down?", "why did ROAS drop?", "why is traffic falling?"). Choose the area closest to the question. Returns Marvyn's calculated findings for that area (what changed, by how much, how confident), the funnel bottleneck, whether tracking can be trusted, the key numbers, and the related recommendations. Explain the answer from this evidence only. Read-only. Every result has a `reliability` object. Present only numbers that are present; a null metric was withheld because there was not enough data, so say that rather than estimating it. If status is "limited", mention the listed missing sources, stale data or small samples. If status is "insufficient", say Marvyn does not have enough data to answer. If sampleData is true, the numbers are Marvyn demo data, not the user's business.

investigate_marketing_problem

Marvyn's current, prioritised recommendations for the user's business, from its checks on their connected data: what to fix or do next, why, the evidence, the expected impact, effort, and how confident Marvyn is. Read-only: it lists recommendations, it does not apply them. Every result has a `reliability` object. Present only numbers that are present; a null metric was withheld because there was not enough data, so say that rather than estimating it. If status is "limited", mention the listed missing sources, stale data or small samples. If status is "insufficient", say Marvyn does not have enough data to answer. If sampleData is true, the numbers are Marvyn demo data, not the user's business.

get_marketing_recommendations

A snapshot of the business across the user's connected Marvyn sources for a period (default the last 30 days, compared with the 30 days before): website traffic and conversions (GA4), paid ads spend and results by platform, Google search clicks, social reach and followers, and store sales. Numbers are calculated by Marvyn from the user's own connected data. Every result has a `reliability` object. Present only numbers that are present; a null metric was withheld because there was not enough data, so say that rather than estimating it. If status is "limited", mention the listed missing sources, stale data or small samples. If status is "insufficient", say Marvyn does not have enough data to answer. If sampleData is true, the numbers are Marvyn demo data, not the user's business.

get_marketing_summary

Returns the connected Marvyn account: the person, their one Marvyn workspace (business name, website, currency, time zone), which data sources are connected and how recent their data is, and which Marvyn features their plan includes. Use it first to know what Marvyn can answer for this user. Every result has a `reliability` object. Present only numbers that are present; a null metric was withheld because there was not enough data, so say that rather than estimating it. If status is "limited", mention the listed missing sources, stale data or small samples. If status is "insufficient", say Marvyn does not have enough data to answer. If sampleData is true, the numbers are Marvyn demo data, not the user's business.

get_profile

Checks whether the user's conversion tracking works over the last 30 days: GA4 key events (set up, firing, or missing), whether the Marvyn Pixel is installed and what it recorded, and whether each connected ad platform is reporting conversions. Use it before trusting any conversion, CPA or ROAS figure. Read-only. Every result has a `reliability` object. Present only numbers that are present; a null metric was withheld because there was not enough data, so say that rather than estimating it. If status is "limited", mention the listed missing sources, stale data or small samples. If status is "insufficient", say Marvyn does not have enough data to answer. If sampleData is true, the numbers are Marvyn demo data, not the user's business.

get_tracking_health

Checks whether AI assistants and AI search engines (ChatGPT, Claude, Perplexity, Google AI) can read a website: whether robots.txt allows their crawlers, whether the site has an llms.txt and a sitemap, and whether the home page is reachable. Works without a Marvyn account. It reads only the public pages of the site the user names. It does not measure rankings, traffic or whether AI assistants recommend the site. Returns each check with pass, warn, fail or unknown, and a fix where one is needed. A result has a `reliability` object: checks marked unknown could not be read and must not be reported as passing.

analyse_website_ai_accessibility