Unified Performance Report

ONE report tool for EVERY connected platform. platform: google_ads | meta (facebook/instagram) | tiktok | linkedin | microsoft | chatgpt_ads (OpenAI ChatGPT Ads) | ga4 | search_console | youtube | business_profile; when omitted, the only connected ad platform is used (platform_note says so). account = that platform's account id (Google Ads customer_id, Meta account_id, GA4 property, Search Console site url, Business Profile location…); empty = the connected/default one. days = lookback window (or start_date/end_date as YYYY-MM-DD). For the ad platforms (google_ads, meta, tiktok, linkedin, microsoft) days=N means the last N FULL days, excluding today, on every platform alike (chatgpt_ads: the last N days up to now in the ad account's time zone; its rows include conversions and conversion_value when conversion tracking is set up), and every reply carries `period` {start, end} = the exact range that was reported: quote that range, not the one you assumed. account_snapshot returns performance SINCE EACH CAMPAIGN STARTED (lifetime) next to a recent window. For metrics or breakdowns this report does not expose, use the platform's free query tool (describe lists it). level = row granularity for ad platforms (campaign | ad_group/adset | ad). breakdown = split rows by a dimension (device, day, country, age, gender, publisher_platform… for GA4/Search Console this is the dimension: channel, source, page, query…). describe(platform) lists exactly which levels and breakdowns that platform supports. For search_console the breakdown also takes a COMBINATION and a SORT: 'page,query' returns which page ranks for which term, and 'query by impressions' sorts by impressions instead of clicks; Search Console itself only returns rows by clicks, so high-impression low-click terms are invisible without it. limit controls the response page size, not the total retrievable data. For a paged Google Ads, Meta, TikTok, LinkedIn, Microsoft, GA4, or Search Console reply, call get_report again with the same platform and page_token=next_page_token; it reads the cached next page without another query or credit. Returns the platform's metric rows.