Sdílet prostřednictvím

SuperMCP (Preview)

SuperMCP by Supermetrics – server MCP (Model Context Protocol) poskytující přístup k marketingovým datům z připojených platforem, jako jsou Google Analytics, Facebook Ads, Google Ads a další.

Toto rozhraní API umožňuje LLM dotazovat se na marketingová data, zjišťovat zdroje dat a účty, zkoumat dostupná pole a načítat metriky výkonu.

Tento konektor je dostupný v následujících produktech a regionech:

Service Class Regions
Copilot Studio Premium Všechny oblasti Power Automate s výjimkou následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Logic Apps Standard Všechny oblasti Logic Apps s výjimkou následujících:
     – Oblasti Azure Government
     – Oblasti Azure China
     - Ministerstvo obrany USA (DoD)
Power Apps Premium Všechny oblasti Power Apps s výjimkou následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Power Automate Premium Všechny oblasti Power Automate s výjimkou následujících:
     – státní správa USA (GCC)
     – státní správa USA (GCC High)
     - China Cloud provozovaný společností 21Vianet
     - Ministerstvo obrany USA (DoD)
Kontakt
Název Supermetrics
URL https://supermetrics.com
Metadata konektoru
Vydavatel Supermetrics
Internetová stránka https://supermetrics.com
Zásady ochrany osobních údajů https://supermetrics.com/privacy
Kategorie Marketing

Vlastní konektor SuperMCP (Supermetrics)

Tento konektor umožňuje Microsoft Power Automate, Power Apps a Azure Logic Apps dotazovat marketingová data prostřednictvím superMCP (server MCP Supermetrics).
Slouží ke zjišťování zdrojů dat a účtů, zkoumání dostupných polí a spouštění dotazů na výkon marketingu.

Vydavatel

Supermetrics

Typ konektoru

Vlastní konektor (Swagger/OpenAPI 2.0)

Služba / rozhraní API

Rozhraní API SuperMCP (server MCP)

  • Hostitel:mcp.supermetrics.com
  • Základní cesta:/
  • Schéma:https

Požadavky

Budete potřebovat:

  • Prostředí Power Automate nebo Power Apps, kde můžete vytvářet vlastní konektory
  • Účet Supermetrics s alespoň jedním připojeným zdrojem dat (např. Google Analytics, Google Ads, Facebook Ads atd.). Pokud nemáte účet Supermetrics, vytvoří se vám při prvním přihlášení jeden se 14denní zkušební verzí.

Autentizace

Tento konektor používá OAuth 2.0.

Podporované operace

Discovery

  • Zjištění dostupných zdrojů dat Supermetrics (POST /mcp/data_source_discovery)
  • Zjišťování účtů pro zdroj dat (POST /mcp/accounts_discovery)
  • Zjištění dostupných polí (POST /mcp/field_discovery)

Dotaz na data

  • Spuštění asynchronního datového dotazu (POST /mcp/data_query)
    • Vrátí hodnotu schedule_id
  • Získání asynchronních výsledků dotazů (POST /mcp/get_async_query_results)
    • Použijte výsledky schedule_id , dokud se nevrátí výsledky.

Nástroje / Prostředky (obvykle pokročilá viditelnost)

  • Získat dnes (UTC) (POST /mcp/get_today)
  • Kontrola stavu (GET /mcp/resources/health)

Support

Licence

Proprietární – © Supermetrice

Limity omezování

Name Volání Období obnovení
Volání API na připojení 100 60 sekund

Akce

Dotazování marketingových dat ze zdrojů dat Supermetrics

Dotazování marketingových dat ze zdrojů dat Supermetrics: Vrátí schedule_id – k získání skutečných dat je nutné volat get_async_query_results.
Kontrola stavu

Získejte informace o stavu serveru a konfiguraci.
Načtení ověřených informací o uživateli ze supermetrice

Načtení ověřených informací o uživateli ze supermetrice
Načtení výsledků datových dotazů pomocí schedule_id

Načtěte výsledky datových dotazů pomocí schedule_id Použijte to s schedule_id z data_query k načtení skutečných výsledků dotazu.
Zjištění dostupných polí pro zdroje dat s informacemi o schématu

Vyhledejte dostupná pole pro zdroje dat s informacemi o schématu. Toto volání zobrazí dostupné metriky a dimenze zdroje dat před dotazováním.
Zjištění dostupných zdrojů dat Supermetrics

Zjištění dostupných zdrojů dat Supermetrics Toto je obvykle první krok – zavolejte ho, abyste zjistili, jaké zdroje dat jsou k dispozici před dotazováním dat.
Zjištění dostupných účtů pro konkrétní zdroj dat

Vyhledejte dostupné účty pro konkrétní volání zdroje dat po data_source_discovery získání ID účtů potřebných pro dotazy na data.
Získání aktuálních informací o datu a čase UTC

Získejte aktuální informace o datu a čase UTC, které volají jako první, když uživatel zmíní relativní data, jako je "minulý měsíc" nebo "včera", aby znal aktuální datum.

Dotazování marketingových dat ze zdrojů dat Supermetrics

ID operace:
dataquery

Dotazování marketingových dat ze zdrojů dat Supermetrics: Vrátí schedule_id – k získání skutečných dat je nutné volat get_async_query_results.

Parametry

Name Klíč Vyžadováno Typ Description
ID zdroje dat
 ds_id True string

ID zdroje dat, které lze načíst pomocí nástroje data_source_discovery Příklady: FA pro Facebook Ads, AW pro Google Ads, GAWA pro Google Analytics.
ds_accounts
 ds_accounts True array of string
pole
 fields True array of string
Typ rozsahu dat
 date_range_type string

Zvolte jeden ze dvou přístupů:

  1. Použijte vlastní a zadejte start_date a end_date.
  2. Použijte relativní rozsah ve formátu last_X_Y (např. "last_7_days", "last_3_months").
    • K zahrnutí aktuálního období (např. last_7_days_inc) můžete připojit _inc.

DŮLEŽITÉ: Pro jakékoli relativní datum zmíněné uživatelem, první volání get_today nástroj znát aktuální rok a datum! Pokud existuje nějaká nejednoznačnost časového období (např. význam "dnes", "tento týden", "poslední srpen" nebo podobné fráze), zavolejte get_today nástroj k potvrzení aktuálního roku a data a pak tuto odpověď použijte k vyplnění tohoto parametru.
Datum zahájení
 start_date string

Vyžaduje se, pokud date_range_type='custom'. Přijímá:

  • Přesné datum ve formátu RRRR-MM-DD (např. '2024-01-01')
  • Datum přirozeného jazyka (např. "včera", "příští pondělí"))

DŮLEŽITÉ: Pro jakékoli relativní datum zmíněné uživatelem, první volání get_today nástroj znát aktuální rok a datum! Pokud existuje nejednoznačnost odkazu na čas (např. relativní fráze jako "dnes", "this week", "end of month"), zavolejte get_today nástroj k potvrzení aktuálního roku a data a pak tuto odpověď použijte k vyplnění tohoto parametru.
Datum ukončení
 end_date string

Vyžaduje se, pokud date_range_type='custom'. Přijímá:

  • Přesné datum ve formátu RRRR-MM-DD (např. '2024-01-31')
  • Datum přirozeného jazyka (např. "včera", "poslední pátek"))

DŮLEŽITÉ: Pro jakékoli relativní datum zmíněné uživatelem, první volání get_today nástroj znát aktuální rok a datum! Pokud existuje nejednoznačnost odkazu na čas (např. relativní fráze jako "dnes", "this week", "end of month"), zavolejte get_today nástroj k potvrzení aktuálního roku a data a pak tuto odpověď použijte k vyplnění tohoto parametru.
Časové pásmo
 timezone string

Volitelně můžete nastavit časové pásmo pro výpočty kalendářních dat (např. Amerika/New_York, Evropa/Londýn, Asie/Tokio). Používá názvy časových pásem IANA. Pokud není zadaný, použije se UTC.
Filtry
 filters string

Řetězec výrazu filtru. Každá podmínka má tvar: [field_name] [operator] [value] Podmínky lze kombinovat s operátorem AND/ OR.

Podporované operátory:

  • '==' → rovná se
  • '!=' → se nerovná
  • ">' → větší než
  • '>=' → větší než nebo rovno
  • '<' → menší než
  • '<=' → menší než nebo rovno
  • '=@' → obsahuje (nerozlišující velká a malá písmena, pouze dimenze)
  • "!@" → neobsahuje (nerozlišuje malá a velká písmena, pouze dimenze)
  • → =~ odpovídá regulárnímu výrazu (pouze dimenze)
  • → '!~' neodpovídá regulárnímu výrazu (pouze dimenze)

Examples:

  • "country == Spojené státy"
  • "country == Spojené státy NEBO země == Kanada"
  • "sessions > 1000 AND deviceCategory == mobile"
  • "campaign_name =@ spring_sale"
  • "pagePath =~ ^/products/.*"
Nastavení
 settings object

Další konfigurace dotazu Použijte objekt JSON, například: {"show_all_time_values": true}. Pokročilá funkce pro konkrétní nastavení zdroje dat Pokud nemáte specifické požadavky, přeskočte.
Typ období porovnání
 compare_type string

Vyberte, jak porovnat výsledky s dřívějším obdobím:

  • "prev_range": předchozí období stejné délky
  • "prev_year": stejné období v předchozím roce
  • "prev_year_weekday": stejné pracovní dny v předchozím roce
  • Vlastní: uživatelem definované období (vyžaduje compare_start_date a compare_end_date)
Typ hodnoty porovnání
 compare_show string

Jak zobrazit porovnání:

  • 'perc_change': procentuální změna (výchozí)
  • 'abs_change': absolutní změna
  • 'value': nezpracovaná hodnota z porovnávací doby
Počáteční datum srovnávacího období
 compare_start_date string

Vyžaduje se, pokud compare_type='custom'. Počáteční datum vlastního srovnávacího období ve formátu RRRR-MM-DD (např. '2024-01-01').
Koncové datum období porovnání
 compare_end_date string

Vyžaduje se, pokud compare_type='custom'. Koncové datum vlastního srovnávacího období ve formátu RRRR-MM-DD (např. 2024-01-31).

Návraty

Body
DataqueryResponse

Kontrola stavu

ID operace:
healthCheck

Získejte informace o stavu serveru a konfiguraci.

Návraty

response
string

Načtení ověřených informací o uživateli ze supermetrice

ID operace:
userinfo

Načtení ověřených informací o uživateli ze supermetrice

Parametry

Name Klíč Vyžadováno Typ Description
object

Návraty

Body
UserinfoResponse

Načtení výsledků datových dotazů pomocí schedule_id

ID operace:
getasyncqueryresults

Načtěte výsledky datových dotazů pomocí schedule_id Použijte to s schedule_id z data_query k načtení skutečných výsledků dotazu.

Parametry

Name Klíč Vyžadováno Typ Description
ID plánu
 schedule_id True string

ID plánu vrácené z požadavku data_query. ID plánu musí být přesně stejné jako v odpovědi data_query. Považovat ID za neprůpadné. Zkopírujte doslovné doslovné zprávy. Zkracujte, formátujte ani parafráze.
Komprimovat odpověď
 compress boolean

Povolení komprese toon pro odpověď

Návraty

Body
GetasyncqueryresultsResponse

Zjištění dostupných polí pro zdroje dat s informacemi o schématu

ID operace:
fielddiscovery

Vyhledejte dostupná pole pro zdroje dat s informacemi o schématu. Toto volání zobrazí dostupné metriky a dimenze zdroje dat před dotazováním.

Parametry

Name Klíč Vyžadováno Typ Description
ID zdroje dat
 ds_id True string

ID zdroje dat, které lze načíst pomocí nástroje data_source_discovery Příklady: FA pro Facebook Ads, AW pro Google Ads, GAWA pro Google Analytics.
Typ pole
 field_type string

Filtrovat podle typu pole (dimenze nebo metriky)
Komprimovat odpověď
 compress boolean

Povolení komprese toon pro odpověď

Návraty

Body
FielddiscoveryResponse

Zjištění dostupných zdrojů dat Supermetrics

ID operace:
datasourcediscovery

Zjištění dostupných zdrojů dat Supermetrics Toto je obvykle první krok – zavolejte ho, abyste zjistili, jaké zdroje dat jsou k dispozici před dotazováním dat.

Parametry

Name Klíč Vyžadováno Typ Description
Komprimovat odpověď
 compress boolean

Povolení komprese toon pro odpověď

Návraty

Body
DatasourcediscoveryResponse

Zjištění dostupných účtů pro konkrétní zdroj dat

ID operace:
accountsdiscovery

Vyhledejte dostupné účty pro konkrétní volání zdroje dat po data_source_discovery získání ID účtů potřebných pro dotazy na data.

Parametry

Name Klíč Vyžadováno Typ Description
ID zdroje dat
 ds_id True string

ID zdroje dat, které lze načíst pomocí nástroje data_source_discovery Příklady: FA pro Facebook Ads, AW pro Google Ads, GAWA pro Google Analytics.
Komprimovat odpověď
 compress boolean

Povolení komprese toon pro odpověď

Návraty

Body
AccountsdiscoveryResponse

Získání aktuálních informací o datu a čase UTC

ID operace:
gettoday

Získejte aktuální informace o datu a čase UTC, které volají jako první, když uživatel zmíní relativní data, jako je "minulý měsíc" nebo "včera", aby znal aktuální datum.

Parametry

Name Klíč Vyžadováno Typ Description
object

Návraty

Body
GettodayResponse

Definice

AccountsdiscoveryResponse

Name Cesta Typ Description
úspěch
 success boolean
accounts
 data.accounts array of object
account_id
 data.accounts.account_id string
account_name
 data.accounts.account_name string

DataqueryResponse

Name Cesta Typ Description
úspěch
 success boolean
schedule_id
 data.schedule_id string

DatasourcediscoveryResponse

Name Cesta Typ Description
úspěch
 success boolean
data_sources
 data.data_sources array of object
identifikační číslo
 data.data_sources.id string
název
 data.data_sources.name string
kategorie
 data.data_sources.category string

FielddiscoveryResponse

Name Cesta Typ Description
úspěch
 success boolean
zdroj dat
 data.data_source string
totální
 data.total integer
metriky
 data.metrics array of object
identifikační číslo
 data.metrics.id string
název
 data.metrics.name string
popis
 data.metrics.description string
dimensions
 data.dimensions array of object
identifikační číslo
 data.dimensions.id string
název
 data.dimensions.name string
popis
 data.dimensions.description string

GetasyncqueryresultsResponse

Name Cesta Typ Description
úspěch
 success boolean
data
 data.data array of object
items
 data.data object
stav
 data.status string

GettodayResponse

Name Cesta Typ Description
úspěch
 success boolean
date
 data.date date
iso_string
 data.iso_string string
časové razítko
 data.timestamp integer

UserinfoResponse

Name Cesta Typ Description
úspěch
 success boolean
uživatelské ID
 data.user_id string
e-mail
 data.email string
název
 data.name string

řetězec

Toto je základní datový typ String.