Aracılığıyla paylaş


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
  • Zaman uyumsuz sorgu sonuçlarını alma (POST /mcp/get_async_query_results)
    • Sonuçlar döndürülene kadar komutunu schedule_id kullanın

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


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

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ü

Sunucu sistem durumu ve yapılandırma bilgilerini alın.

Döndürülenler

response
string

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

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:

  1. 'özel' kullanın ve start_date ve end_date sağlayın.
  2. 'last_X_Y' biçiminde göreli bir aralık kullanın (örneğin, 'last_7_days', 'last_3_months').
    • Geçerli dönemi içerecek şekilde '_inc' ekleyebilirsiniz (örneğin, 'last_7_days_inc').

Ö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 get_today ve ardından bu parametreyi doldurmak için bu yanıtı kullanın.

Başlangıç Tarihi
start_date string

date_range_type='custom' ise gereklidir. Kabul:

  • YYYY-MM-DD biçiminde tam tarih (ör. '2024-01-01')
  • Doğal dil tarihi (örneğin, 'dün', 'sonraki Pazartesi')

Ö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 get_today ve ardından bu parametreyi doldurmak için bu yanıtı kullanın.

Bitiş Tarihi
end_date string

date_range_type='custom' ise gereklidir. Kabul:

  • YYYY-MM-DD biçiminde tam tarih (ör. '2024-01-31')
  • Doğal dil tarihi (örneğin, 'dün', 'son Cuma')

Ö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 get_today ve ardından bu parametreyi doldurmak için bu yanıtı kullanı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:

  • '==' → eşittir
  • '!=' → eşit değil
  • '>' → büyüktür
  • '>=' → büyüktür veya eşittir
  • '<' → küçüktür
  • '<=' küçük veya eşit →
  • '=@' → içerir (büyük/küçük harfe duyarsız, yalnızca boyutlar)
  • '!@' → içermez (büyük/küçük harfe duyarsız, yalnızca boyutlar)
  • '=~' → normal ifadeyle eşleşir (yalnızca boyutlar)
  • '!~' → normal ifadeyle eşleşmiyor (yalnızca boyutlar)

Examples:

  • "ülke == Amerika Birleşik Devletleri"
  • "ülke == ABD VEYA ülke == Kanada"
  • "sessions > 1000 AND deviceCategory == mobile"
  • "campaign_name =@ spring_sale"
  • "pagePath =~ ^/products/.*"
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:

  • 'prev_range': aynı uzunlukta önceki dönem
  • 'prev_year': önceki yılın aynı dönemi
  • 'prev_year_weekday': önceki yılın aynı hafta içi günleri
  • 'custom': kullanıcı tanımlı dönem (compare_start_date ve compare_end_date gerektirir)
Karşılaştırma Değeri Türü
compare_show string

Karşılaştırma nasıl görüntülenir:

  • 'perc_change': yüzde değişikliği (varsayılan)
  • 'abs_change': mutlak değişiklik
  • 'value': Karşılaştırma döneminden ham değer
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

Ş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.