SuperMCP (Önizleme)
Supermetrics tarafından üretilen SuperMCP - Google Analytics, Facebook Ads, Google Ads ve daha fazlası gibi bağlı platformlardan pazarlama verilerine erişim sağlayan bir MCP (Model Bağlam Protokolü) sunucusu.
Bu API, LLM'lerin pazarlama verilerini sorgulamasını, veri kaynaklarını ve hesapları keşfetmesini, kullanılabilir alanları keşfetmesini ve performans ölçümlerini almasını sağlar.
Bu bağlayıcı aşağıdaki ürün ve bölgelerde kullanılabilir:
| Hizmet | Class | Bölgeler |
|---|---|---|
| Copilot Studio | Premium | Aşağıdakiler dışında tüm Power Automate bölgeleri : - ABD Kamu (GCC) - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD) |
| Logic Apps | Standart | Aşağıdakiler dışında tüm Logic Apps bölgeleri : - Azure Kamu bölgeleri - Azure Çin bölgeleri - ABD Savunma Bakanlığı (DoD) |
| Power Apps | Premium | Aşağıdakiler dışında tüm Power Apps bölgeleri : - ABD Kamu (GCC) - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD) |
| Power Automate | Premium | Aşağıdakiler dışında tüm Power Automate bölgeleri : - ABD Kamu (GCC) - US Government (GCC High) - 21Vianet tarafından işletilen Çin Bulutu - ABD Savunma Bakanlığı (DoD) |
| İletişim | |
|---|---|
| İsim | Süpermetrik |
| URL | https://supermetrics.com |
| Bağlayıcı Meta Verileri | |
|---|---|
| Publisher | Süpermetrik |
| Web sitesi | https://supermetrics.com |
| Gizlilik ilkesi | https://supermetrics.com/privacy |
| Kategoriler | Pazarlama |
SuperMCP (Supermetrics) Özel Bağlayıcısı
Bu bağlayıcı Microsoft Power Automate, Power Apps ve Azure Logic Apps'in SuperMCP (Supermetrics'in MCP sunucusu) aracılığıyla pazarlama verilerini sorgulamasını sağlar.
Veri kaynaklarını ve hesapları bulmak, kullanılabilir alanları keşfetmek ve pazarlama performansı sorguları çalıştırmak için bunu kullanın.
Publisher
Supermetrics
Bağlayıcı türü
Özel Bağlayıcı (Swagger/OpenAPI 2.0)
Hizmet / API
SuperMCP API (MCP sunucusu)
-
Ev sahibi:
mcp.supermetrics.com -
Temel yol:
/ -
Düzeni:
https
Önkoşullar
Gerekenler:
- Özel bağlayıcılar oluşturabileceğiniz bir Power Automate veya Power Apps ortamı
- En az bir bağlı veri kaynağına (ör. Google Analytics, Google Ads, Facebook Ads vb.) sahip bir Supermetrics hesabı. Supermetrics hesabınız yoksa, ilk oturum açmada sizin için 14 günlük deneme sürümüne sahip bir hesap oluşturulur.
Authentication
Bu bağlayıcı OAuth 2.0 kullanır.
Desteklenen İşlemler
Keşif
-
Kullanılabilir Supermetrics veri kaynaklarını bulma (
POST /mcp/data_source_discovery) -
Veri kaynağı için hesapları bulma (
POST /mcp/accounts_discovery) -
Kullanılabilir alanları bulma (
POST /mcp/field_discovery)
Veri Sorgusu
-
Zaman uyumsuz veri sorgusu çalıştırma (
POST /mcp/data_query)- Şunu döndürür:
schedule_id
- Şunu döndürür:
-
Zaman uyumsuz sorgu sonuçlarını alma (
POST /mcp/get_async_query_results)- Sonuçlar döndürülene kadar komutunu
schedule_idkullanın
- Sonuçlar döndürülene kadar komutunu
Yardımcı Programlar / Kaynaklar (genellikle gelişmiş görünürlük)
-
Bugün alın (UTC) (
POST /mcp/get_today) -
Sistem durumu denetimi (
GET /mcp/resources/health)
Support
- Web sitesi:https://supermetrics.com
- MCP sunucu belgeleri:https://mcp.supermetrics.com
- Destek:https://support.supermetrics.com
Lisans
Özel — © Süpermetrik
Azaltma Sınırları
| Name | Çağrılar | Yenileme Dönemi |
|---|---|---|
| Bağlantı başına API çağrıları | 100 | 60 saniye |
Eylemler
| Belirli bir veri kaynağı için kullanılabilir hesapları bulma |
Belirli bir veri kaynağı için kullanılabilir hesapları bulma Veri sorguları için gereken hesap kimliklerini almak için data_source_discovery sonra bunu arayın. |
| Geçerli UTC tarih ve saat bilgilerini alma |
Geçerli UTC tarih ve saat bilgilerini alma Geçerli tarihi öğrenmek için kullanıcı 'geçen ay' veya 'dün' gibi göreli tarihlerden bahsettiğinde ilk olarak bunu çağırın. |
| Kullanılabilir Supermetrics veri kaynaklarını bulma |
Kullanılabilir Supermetrics veri kaynaklarını bulma Bu genellikle ilk adımdır; verileri sorgulamadan önce hangi veri kaynaklarının kullanılabilir olduğunu görmek için bunu çağırın. |
| Sağlık kontrolü |
Sunucu sistem durumu ve yapılandırma bilgilerini alın. |
| schedule_id kullanarak veri sorgularının sonuçlarını alma |
schedule_id kullanarak veri sorgularının sonuçlarını alma Gerçek sorgu sonuçlarını almak için data_query schedule_id bunu kullanın. |
| Supermetrics'ten kimliği doğrulanmış kullanıcı bilgilerini alma |
Supermetrics'ten kimliği doğrulanmış kullanıcı bilgilerini alma |
| Supermetrics veri kaynaklarından pazarlama verilerini sorgulama |
Supermetrics veri kaynaklarından pazarlama verilerini sorgulama Bu bir schedule_id döndürür; ardından gerçek verileri almak için get_async_query_results çağırmanız gerekir. |
| Şema bilgileriyle veri kaynakları için kullanılabilir alanları bulma |
Şema bilgileriyle veri kaynakları için kullanılabilir alanları bulma Sorgulamadan önce bir veri kaynağının kullanılabilir ölçümlerini ve boyutlarını görmek için bunu çağırın. |
Belirli bir veri kaynağı için kullanılabilir hesapları bulma
Belirli bir veri kaynağı için kullanılabilir hesapları bulma Veri sorguları için gereken hesap kimliklerini almak için data_source_discovery sonra bunu arayın.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Veri Kaynağı Kimliği
|
ds_id | True | string |
data_source_discovery aracı kullanılarak alınabilen veri kaynağı kimliği. Örnekler: Facebook Reklamları için 'FA', Google Ads için 'AW', Google Analytics için 'GAWA'. |
|
Yanıtı sıkıştır
|
compress | boolean |
Yanıt için toon sıkıştırmayı etkinleştirme |
Döndürülenler
Geçerli UTC tarih ve saat bilgilerini alma
Geçerli UTC tarih ve saat bilgilerini alma Geçerli tarihi öğrenmek için kullanıcı 'geçen ay' veya 'dün' gibi göreli tarihlerden bahsettiğinde ilk olarak bunu çağırın.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
|
object |
Döndürülenler
- Body
- GettodayResponse
Kullanılabilir Supermetrics veri kaynaklarını bulma
Kullanılabilir Supermetrics veri kaynaklarını bulma Bu genellikle ilk adımdır; verileri sorgulamadan önce hangi veri kaynaklarının kullanılabilir olduğunu görmek için bunu çağırın.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Yanıtı sıkıştır
|
compress | boolean |
Yanıt için toon sıkıştırmayı etkinleştirme |
Döndürülenler
Sağlık kontrolü
schedule_id kullanarak veri sorgularının sonuçlarını alma
schedule_id kullanarak veri sorgularının sonuçlarını alma Gerçek sorgu sonuçlarını almak için data_query schedule_id bunu kullanın.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Zamanlama Kimliği
|
schedule_id | True | string |
data_query isteğinden döndürülen zamanlama kimliği. Zamanlama kimliği, data_query yanıtında döndürülen kimlikle tam olarak aynı olmalıdır. Kimlikleri opak olarak değerlendirin. Ayrıntılı ifadeyi kopyalayın. Kısaltma, biçim veya parola kullanmayın. |
|
Yanıtı sıkıştır
|
compress | boolean |
Yanıt için toon sıkıştırmayı etkinleştirme |
Döndürülenler
Supermetrics'ten kimliği doğrulanmış kullanıcı bilgilerini alma
Supermetrics'ten kimliği doğrulanmış kullanıcı bilgilerini alma
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
|
object |
Döndürülenler
- Body
- UserinfoResponse
Supermetrics veri kaynaklarından pazarlama verilerini sorgulama
Supermetrics veri kaynaklarından pazarlama verilerini sorgulama Bu bir schedule_id döndürür; ardından gerçek verileri almak için get_async_query_results çağırmanız gerekir.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Veri Kaynağı Kimliği
|
ds_id | True | string |
data_source_discovery aracı kullanılarak alınabilen veri kaynağı kimliği. Örnekler: Facebook Reklamları için 'FA', Google Ads için 'AW', Google Analytics için 'GAWA'. |
|
ds_accounts
|
ds_accounts | True | array of string | |
|
Alanları
|
fields | True | array of string | |
|
Tarih Aralığı Türü
|
date_range_type | string |
İki yaklaşımdan birini seçin:
ÖNEMLİ: Kullanıcı tarafından bahsedilen herhangi bir göreli tarih için, İlk olarak geçerli yılı ve tarihi öğrenmek için get_today aracını arayın!
Zaman aralığı hakkında herhangi bir belirsizlik varsa (örneğin, 'bugün', 'bu hafta', 'son Ağustos' veya benzer ifadelerin anlamı), geçerli yılı ve tarihi onaylamak için aracı çağırın |
|
|
Başlangıç Tarihi
|
start_date | string |
date_range_type='custom' ise gereklidir. Kabul:
ÖNEMLİ: Kullanıcı tarafından bahsedilen herhangi bir göreli tarih için, İlk olarak geçerli yılı ve tarihi öğrenmek için get_today aracını arayın!
Zaman başvurusu hakkında belirsizlik varsa (örneğin, 'bugün', 'bu hafta', 'ay sonu' gibi göreli ifadeler), geçerli yılı ve tarihi onaylamak için aracı çağırın |
|
|
Bitiş Tarihi
|
end_date | string |
date_range_type='custom' ise gereklidir. Kabul:
ÖNEMLİ: Kullanıcı tarafından bahsedilen herhangi bir göreli tarih için, İlk olarak geçerli yılı ve tarihi öğrenmek için get_today aracını arayın!
Zaman başvurusu hakkında belirsizlik varsa (örneğin, 'bugün', 'bu hafta', 'ay sonu' gibi göreli ifadeler), geçerli yılı ve tarihi onaylamak için aracı çağırın |
|
|
Saat dilimi
|
timezone | string |
İsteğe bağlı olarak tarih hesaplamaları için saat dilimini ayarlayın (örneğin, 'Amerika/New_York', 'Avrupa/Londra', 'Asya/Tokyo'). IANA saat dilimi adlarını kullanır. Belirtilmezse UTC kullanır. |
|
|
Filtreler
|
filters | string |
Filtre ifadesi dizesi. Her koşul şu forma sahiptir: [field_name] [işleç] [değer] Koşullar AND / OR ile birleştirilebilir. Desteklenen işleçler:
Examples:
|
|
|
Settings
|
settings | object |
Ek sorgu yapılandırması. Bir JSON nesnesi kullanın, örneğin: {"show_all_time_values": true}. Belirli veri kaynağı ayarları için gelişmiş özellik. Belirli gereksinimleriniz olmadığı sürece atlayın. |
|
|
Karşılaştırma Dönemi Türü
|
compare_type | string |
Sonuçları önceki bir dönemle karşılaştırmayı seçin:
|
|
|
Karşılaştırma Değeri Türü
|
compare_show | string |
Karşılaştırma nasıl görüntülenir:
|
|
|
Karşılaştırma Dönemi Başlangıç Tarihi
|
compare_start_date | string |
compare_type='custom' ise gereklidir. Özel karşılaştırma döneminin başlangıç tarihi, YYYY-MM-DD biçimindedir (örneğin, '2024-01-01'). |
|
|
Karşılaştırma Dönemi Bitiş Tarihi
|
compare_end_date | string |
compare_type='custom' ise gereklidir. YYYY-MM-DD biçiminde (örneğin, '2024-01-31') özel karşılaştırma döneminin bitiş tarihi. |
Döndürülenler
- Body
- DataqueryResponse
Şema bilgileriyle veri kaynakları için kullanılabilir alanları bulma
Şema bilgileriyle veri kaynakları için kullanılabilir alanları bulma Sorgulamadan önce bir veri kaynağının kullanılabilir ölçümlerini ve boyutlarını görmek için bunu çağırın.
Parametreler
| Name | Anahtar | Gerekli | Tür | Description |
|---|---|---|---|---|
|
Veri Kaynağı Kimliği
|
ds_id | True | string |
data_source_discovery aracı kullanılarak alınabilen veri kaynağı kimliği. Örnekler: Facebook Reklamları için 'FA', Google Ads için 'AW', Google Analytics için 'GAWA'. |
|
Alan türü
|
field_type | string |
Alan türüne göre filtreleme (boyut veya ölçüm) |
|
|
Yanıtı sıkıştır
|
compress | boolean |
Yanıt için toon sıkıştırmayı etkinleştirme |
Döndürülenler
Tanımlar
AccountsdiscoveryResponse
| Name | Yol | Tür | Description |
|---|---|---|---|
|
başarı
|
success | boolean | |
|
accounts
|
data.accounts | array of object | |
|
account_id
|
data.accounts.account_id | string | |
|
account_name
|
data.accounts.account_name | string |
DataqueryResponse
| Name | Yol | Tür | Description |
|---|---|---|---|
|
başarı
|
success | boolean | |
|
schedule_id
|
data.schedule_id | string |
DatasourcediscoveryResponse
| Name | Yol | Tür | Description |
|---|---|---|---|
|
başarı
|
success | boolean | |
|
data_sources
|
data.data_sources | array of object | |
|
kimlik
|
data.data_sources.id | string | |
|
name
|
data.data_sources.name | string | |
|
kategori
|
data.data_sources.category | string |
FielddiscoveryResponse
| Name | Yol | Tür | Description |
|---|---|---|---|
|
başarı
|
success | boolean | |
|
veri_kaynağı
|
data.data_source | string | |
|
toplam
|
data.total | integer | |
|
metrics
|
data.metrics | array of object | |
|
kimlik
|
data.metrics.id | string | |
|
name
|
data.metrics.name | string | |
|
açıklama
|
data.metrics.description | string | |
|
dimensions
|
data.dimensions | array of object | |
|
kimlik
|
data.dimensions.id | string | |
|
name
|
data.dimensions.name | string | |
|
açıklama
|
data.dimensions.description | string |
GetasyncqueryresultsResponse
| Name | Yol | Tür | Description |
|---|---|---|---|
|
başarı
|
success | boolean | |
|
veriler
|
data.data | array of object | |
|
items
|
data.data | object | |
|
statü
|
data.status | string |
GettodayResponse
| Name | Yol | Tür | Description |
|---|---|---|---|
|
başarı
|
success | boolean | |
|
date
|
data.date | date | |
|
iso_string
|
data.iso_string | string | |
|
Tarih damgası
|
data.timestamp | integer |
UserinfoResponse
| Name | Yol | Tür | Description |
|---|---|---|---|
|
başarı
|
success | boolean | |
|
kullanıcı_kimliği
|
data.user_id | string | |
|
e-posta
|
data.email | string | |
|
name
|
data.name | string |
String
Bu, 'string' temel veri türüdür.