Condividi tramite

SuperMCP (anteprima)

SuperMCP di Supermetrics - Un server MCP (Model Context Protocol) che fornisce l'accesso ai dati di marketing da piattaforme connesse come Google Analytics, Facebook Ads, Google Ads e altro ancora.

Questa API consente alle macchine virtuali di eseguire query sui dati di marketing, individuare origini dati e account, esplorare i campi disponibili e recuperare le metriche delle prestazioni.

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Servizio Class Regions
Copilot Studio Di alta qualità Tutte le aree di Power Automate , ad eccezione delle seguenti:
     - Governo degli Stati Uniti (GCC)
     - Us Government (GCC High)
     - China Cloud gestito da 21Vianet
     - Dipartimento della Difesa degli Stati Uniti (DoD)
App per la logica Normale Tutte le aree di App per la logica , ad eccezione delle seguenti:
     - Aree di Azure per enti pubblici
     - Aree di Azure Cina
     - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Apps Di alta qualità Tutte le aree di Power Apps , ad eccezione dei seguenti:
     - Governo degli Stati Uniti (GCC)
     - Us Government (GCC High)
     - China Cloud gestito da 21Vianet
     - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Automate Di alta qualità Tutte le aree di Power Automate , ad eccezione delle seguenti:
     - Governo degli Stati Uniti (GCC)
     - Us Government (GCC High)
     - China Cloud gestito da 21Vianet
     - Dipartimento della Difesa degli Stati Uniti (DoD)
Contatto
Nome Supermetrics
URL https://supermetrics.com
Metadati del connettore
Editore Supermetrics
Sito web https://supermetrics.com
Informativa sulla privacy https://supermetrics.com/privacy
Categorie Commercializzazione

Connettore personalizzato SuperMCP (Supermetrics)

Questo connettore consente a Microsoft Power Automate, Power Apps e App per la logica di Azure di eseguire query sui dati di marketing tramite SuperMCP (server MCP di Supermetrics).
Usarlo per individuare origini dati e account, esplorare i campi disponibili ed eseguire query sulle prestazioni di marketing.

Editore

Supermetrics

Tipo di connettore

Connettore personalizzato (Swagger/OpenAPI 2.0)

Servizio/API

API SuperMCP (server MCP)

  • Ospite:mcp.supermetrics.com
  • Percorso di base:/
  • Schema:https

Prerequisiti

Sarà necessario:

  • Un ambiente Power Automate o Power Apps in cui è possibile creare connettori personalizzati
  • Un account Supermetrics con almeno un'origine dati connessa ,ad esempio Google Analytics, Google Ads, Facebook Ads e così via. Se non si ha un account Supermetrics, ne verrà creato uno con una versione di valutazione di 14 giorni al primo accesso.

Authentication

Questo connettore usa OAuth 2.0.

Operazioni supportate

Scoperta

  • Individuare le origini dati supermetriche disponibili (POST /mcp/data_source_discovery)
  • Individuare gli account per un'origine dati (POST /mcp/accounts_discovery)
  • Individuare i campi disponibili (POST /mcp/field_discovery)

Query di dati

  • Eseguire una query di dati asincrona (POST /mcp/data_query)
    • Restituisce un oggetto schedule_id
  • Ottenere i risultati della query asincrona (POST /mcp/get_async_query_results)
    • Usare finché schedule_id non vengono restituiti i risultati

Utilità/Risorse (in genere visibilità avanzata)

  • Ottieni oggi (UTC) (POST /mcp/get_today)
  • Controllo integrità (GET /mcp/resources/health)

Support

Licenza

Proprietario - © Supermetriche

Limiti per la limitazione delle richieste

Nome Chiamate Periodo di rinnovo
Chiamate API per connessione 100 60 secondi

Azioni

Controllo sanitario

Ottenere informazioni sullo stato di integrità del server e sulla configurazione.
Eseguire query sui dati di marketing da origini dati Supermetrics

Eseguire query sui dati di marketing da origini dati Supermetrics. Viene restituito un schedule_id. È quindi necessario chiamare get_async_query_results per ottenere i dati effettivi.
Individuare gli account disponibili per un'origine dati specifica

Individuare gli account disponibili per un'origine dati specifica Chiamare questa operazione dopo data_source_discovery per ottenere gli ID account necessari per le query di dati.
Individuare i campi disponibili per le origini dati con informazioni sullo schema

Individuare i campi disponibili per le origini dati con informazioni sullo schema Chiamare questa opzione per visualizzare le metriche e le dimensioni disponibili per un'origine dati prima di eseguire query.
Individuare le origini dati supermetriche disponibili

Individuare le origini dati Supermetrics disponibili Questo è in genere il primo passaggio. Chiamare questa operazione per vedere quali origini dati sono disponibili prima di eseguire query sui dati.
Ottenere le informazioni correnti sulla data e l'ora UTC

Ottenere le informazioni correnti sulla data e sull'ora UTC Chiama questa prima volta quando l'utente menziona date relative, ad esempio 'last month' o 'yesterday' per conoscere la data corrente.
Recuperare i risultati delle query di dati usando schedule_id

Recuperare i risultati delle query di dati usando schedule_id Usare con il schedule_id da data_query per recuperare i risultati effettivi della query.
Recuperare le informazioni utente autenticate da Supermetrics

Recuperare le informazioni utente autenticate da Supermetrics

Controllo sanitario

ID operazione:
healthCheck

Ottenere informazioni sullo stato di integrità del server e sulla configurazione.

Restituisce

response
string

Eseguire query sui dati di marketing da origini dati Supermetrics

ID operazione:
dataquery

Eseguire query sui dati di marketing da origini dati Supermetrics. Viene restituito un schedule_id. È quindi necessario chiamare get_async_query_results per ottenere i dati effettivi.

Parametri

Nome Chiave Necessario Tipo Descrizione
ID origine dati
 ds_id True string

ID origine dati che può essere recuperato usando lo strumento di data_source_discovery. Esempi: 'FA' per Facebook Ads, 'AW' per Google Ads, 'GAWA' per Google Analytics.
ds_accounts
 ds_accounts True array of string
fields
 fields True array of string
Tipo di intervallo date
 date_range_type string

Scegliere uno dei due approcci seguenti:

  1. Usare 'custom' e fornire start_date e end_date.
  2. Usare un intervallo relativo nel formato 'last_X_Y', ad esempio 'last_7_days', 'last_3_months').
    • È possibile aggiungere "_inc" per includere il periodo corrente ,ad esempio "last_7_days_inc".

IMPORTANTE: per qualsiasi data relativa menzionata dall'utente, chiamare get_today strumento per conoscere l'anno e la data correnti! Se si verificano ambiguità sul periodo di tempo (ad esempio, il significato di "oggi", "questa settimana", "ultimo agosto" o frasi simili), chiamare lo get_today strumento per confermare l'anno e la data correnti, quindi usare tale risposta per compilare questo parametro.
Data di inizio
 start_date string

Obbligatorio se date_range_type='custom'. Accetta:

  • Data esatta in formato AAAA-MM-DD (ad esempio, '2024-01-01')
  • Data del linguaggio naturale (ad esempio, 'ieri', 'lunedì prossimo')

IMPORTANTE: per qualsiasi data relativa menzionata dall'utente, chiamare get_today strumento per conoscere l'anno e la data correnti! Se si verificano ambiguità sul riferimento temporale (ad esempio, frasi relative come "oggi", "questa settimana", "fine del mese"), chiamare lo get_today strumento per confermare l'anno e la data correnti, quindi usare tale risposta per compilare questo parametro.
Data di fine
 end_date string

Obbligatorio se date_range_type='custom'. Accetta:

  • Data esatta in formato AAAA-MM-DD (ad esempio, '2024-01-31')
  • Data del linguaggio naturale (ad esempio, 'ieri', 'last Friday')

IMPORTANTE: per qualsiasi data relativa menzionata dall'utente, chiamare get_today strumento per conoscere l'anno e la data correnti! Se si verificano ambiguità sul riferimento temporale (ad esempio, frasi relative come "oggi", "questa settimana", "fine del mese"), chiamare lo get_today strumento per confermare l'anno e la data correnti, quindi usare tale risposta per compilare questo parametro.
Fuso orario
 timezone string

Facoltativamente, impostare il fuso orario per i calcoli di data ,ad esempio 'America/New_York', 'Europa/Londra', 'Asia/Tokyo'). Usa nomi di fuso orario IANA. Se non specificato, usa l'ora UTC.
Filtri
 filters string

Stringa dell'espressione di filtro. Ogni condizione ha il formato [ field_name] [operatore] [valore] Le condizioni possono essere combinate con AND/OR.

Operatori supportati:

  • '==' → uguale a
  • '!=' → non è uguale a
  • '>' → maggiore di
  • '>=' → maggiore o uguale a
  • '<' → minore di
  • '<=' → minore o uguale a
  • '=@' → contiene (senza distinzione tra maiuscole e minuscole, solo dimensioni)
  • '!@' → non contiene (solo senza distinzione tra maiuscole e minuscole, dimensioni)
  • '=~' → corrisponde a un'espressione regolare (solo dimensioni)
  • '!~' → non corrisponde all'espressione regolare (solo dimensioni)

Examples:

  • "country == Stati Uniti"
  • "country == United States OR country == Canada"
  • "sessions > 1000 AND deviceCategory == mobile"
  • "campaign_name =@ spring_sale"
  • "pagePath =~ ^/products/.*"
Settings
 settings object

Configurazione di query aggiuntiva. Usare un oggetto JSON, ad esempio: {"show_all_time_values": true}. Funzionalità avanzata per impostazioni specifiche dell'origine dati. Ignorare, a meno che non si disponga di requisiti specifici.
Tipo periodo di confronto
 compare_type string

Selezionare come confrontare i risultati con un periodo precedente:

  • 'prev_range': periodo precedente della stessa lunghezza
  • 'prev_year': stesso periodo dell'anno precedente
  • 'prev_year_weekday': stessi giorni feriali dell'anno precedente
  • 'custom': periodo definito dall'utente (richiede compare_start_date e compare_end_date)
Tipo di valore di confronto
 compare_show string

Come visualizzare il confronto:

  • 'perc_change': variazione percentuale (impostazione predefinita)
  • 'abs_change': cambiamento assoluto
  • 'value': valore non elaborato del periodo di confronto
Data di inizio periodo di confronto
 compare_start_date string

Obbligatorio se compare_type='custom'. Data di inizio del periodo di confronto personalizzato, in formato AAAA-MM-DD (ad esempio, '2024-01-01').
Data di fine periodo di confronto
 compare_end_date string

Obbligatorio se compare_type='custom'. Data di fine del periodo di confronto personalizzato, in formato AAAA-MM-DD (ad esempio, '2024-01-31').

Restituisce

Corpo
DataqueryResponse

Individuare gli account disponibili per un'origine dati specifica

ID operazione:
accountsdiscovery

Individuare gli account disponibili per un'origine dati specifica Chiamare questa operazione dopo data_source_discovery per ottenere gli ID account necessari per le query di dati.

Parametri

Nome Chiave Necessario Tipo Descrizione
ID origine dati
 ds_id True string

ID origine dati che può essere recuperato usando lo strumento di data_source_discovery. Esempi: 'FA' per Facebook Ads, 'AW' per Google Ads, 'GAWA' per Google Analytics.
Comprimi risposta
 compress boolean

Abilitare la compressione toon per la risposta

Restituisce

Corpo
AccountsdiscoveryResponse

Individuare i campi disponibili per le origini dati con informazioni sullo schema

ID operazione:
fielddiscovery

Individuare i campi disponibili per le origini dati con informazioni sullo schema Chiamare questa opzione per visualizzare le metriche e le dimensioni disponibili per un'origine dati prima di eseguire query.

Parametri

Nome Chiave Necessario Tipo Descrizione
ID origine dati
 ds_id True string

ID origine dati che può essere recuperato usando lo strumento di data_source_discovery. Esempi: 'FA' per Facebook Ads, 'AW' per Google Ads, 'GAWA' per Google Analytics.
Tipo di campo
 field_type string

Filtrare in base al tipo di campo (dimensione o metrica)
Comprimi risposta
 compress boolean

Abilitare la compressione toon per la risposta

Restituisce

Corpo
FielddiscoveryResponse

Individuare le origini dati supermetriche disponibili

ID operazione:
datasourcediscovery

Individuare le origini dati Supermetrics disponibili Questo è in genere il primo passaggio. Chiamare questa operazione per vedere quali origini dati sono disponibili prima di eseguire query sui dati.

Parametri

Nome Chiave Necessario Tipo Descrizione
Comprimi risposta
 compress boolean

Abilitare la compressione toon per la risposta

Restituisce

Corpo
DatasourcediscoveryResponse

Ottenere le informazioni correnti sulla data e l'ora UTC

ID operazione:
gettoday

Ottenere le informazioni correnti sulla data e sull'ora UTC Chiama questa prima volta quando l'utente menziona date relative, ad esempio 'last month' o 'yesterday' per conoscere la data corrente.

Parametri

Nome Chiave Necessario Tipo Descrizione
object

Restituisce

Corpo
GettodayResponse

Recuperare i risultati delle query di dati usando schedule_id

ID operazione:
getasyncqueryresults

Recuperare i risultati delle query di dati usando schedule_id Usare con il schedule_id da data_query per recuperare i risultati effettivi della query.

Parametri

Nome Chiave Necessario Tipo Descrizione
ID pianificazione
 schedule_id True string

ID pianificazione restituito da una richiesta di data_query. L'ID pianificazione deve essere esattamente uguale a quello restituito nella risposta data_query. Considera gli ID come opachi. Copiare verbatim. Non abbreviare, formattare o paraphrase.
Comprimi risposta
 compress boolean

Abilitare la compressione toon per la risposta

Restituisce

Corpo
GetasyncqueryresultsResponse

Recuperare le informazioni utente autenticate da Supermetrics

ID operazione:
userinfo

Recuperare le informazioni utente autenticate da Supermetrics

Parametri

Nome Chiave Necessario Tipo Descrizione
object

Restituisce

Corpo
UserinfoResponse

Definizioni

AccountsdiscoveryResponse

Nome Percorso Tipo Descrizione
successo
 success boolean
accounts
 data.accounts array of object
account_id
 data.accounts.account_id string
account_name
 data.accounts.account_name string

DataqueryResponse

Nome Percorso Tipo Descrizione
successo
 success boolean
schedule_id
 data.schedule_id string

DatasourcediscoveryResponse

Nome Percorso Tipo Descrizione
successo
 success boolean
data_sources
 data.data_sources array of object
id
 data.data_sources.id string
nome
 data.data_sources.name string
categoria
 data.data_sources.category string

FielddiscoveryResponse

Nome Percorso Tipo Descrizione
successo
 success boolean
fonte_dati
 data.data_source string
totale
 data.total integer
metrics
 data.metrics array of object
id
 data.metrics.id string
nome
 data.metrics.name string
descrizione
 data.metrics.description string
dimensions
 data.dimensions array of object
id
 data.dimensions.id string
nome
 data.dimensions.name string
descrizione
 data.dimensions.description string

GetasyncqueryresultsResponse

Nome Percorso Tipo Descrizione
successo
 success boolean
data
 data.data array of object
items
 data.data object
status
 data.status string

GettodayResponse

Nome Percorso Tipo Descrizione
successo
 success boolean
date
 data.date date
iso_string
 data.iso_string string
Marca temporale
 data.timestamp integer

UserinfoResponse

Nome Percorso Tipo Descrizione
successo
 success boolean
ID_utente
 data.user_id string
posta elettronica
 data.email string
nome
 data.name string

corda

Si tratta del tipo di dati di base 'string'.