MCP Entegrasyon Kılavuzu

Okumak TimesFM 2.5 toplam trend/kantil hazırlığı ve kiracı-özel entegrasyonu 7/30/90 günlük hazırlığı. Eğitim/doğrulama bekleniyor, bu açıkça belirtilmiştir. Gerektirir predictions:read.

Bir tüketici tahmini: bir sonraki etkinliğin nihai dağılımı/sıralaması artı CWM + TimesFM 7/30/90d purchaseWindows. Kazanılmış kiracı olay modeli tercih edilir; bir dahili, kamuya açık öncelikli referans yedekleme mekanizması. Bireysel uzman çıktıları yok. Olay olasılıkları kalibre edilmemiş; satın alma pencereleri. null Eğitim/onay süreci tamamlanana kadar. Gerektirir. predictions:read; metrics:read Ayrıca satın alma pencerelerine de olanak tanır.

Marka/kategori günlük metriklerini TimesFM 2.5 ile tahmin et: nokta + q10..q90. Eksik geçmiş null döndürür. Toplam kantiller kalibre edilmemiştir; asla kişisel aralıklar değildir. predictions:read VE metrics:read gerektirir.

Kiracı-özel CWM + TimesFM 7/30/90d'deki satın alma olasılıkları (0–1). Eğitim ve doğrulama yapılana kadar sıfır; yapay yedekleme yok. Gerektirir predictions:read AND metrics:read.

Bu ekip için yönetilen anlamsal katmandan (anahtar, etiket, birim, sertifikasyon, kategori) mevcut olan ölçütleri listeleyin. Geçerli ölçüt anahtarlarını keşfetmek için önce arayın. metrics:read gerektirir.

Bir ölçütün tüm özelliklerini edinin: yetkili tanım, birim, sertifikasyon, boyutlar, filtrelenebilir alanlar, ayarlanabilir parametreler ve kullanım kılavuzu. Gereksinimler metrics:read.

Yönetilen bir metrik sorgusu çalıştırın ve sayıları yetkili tanımlarıyla birlikte döndürün. Bir metrik anahtarı ve isteğe bağlı boyutlar, filtreler, zaman aralığı, ayrıntı düzeyi ve dönemler arası karşılaştırma seçin — asla SQL kullanmayın. metrics:read gerektirir.

Belirli bir zaman dilimi içinde tek bir boyuta göre bir metriği ayrıntılı olarak inceleyin ve insan tarafından okunabilir etiketler (mağaza/katman/kanal adları) kullanın. Gereksinimler: metrics:read.

Doğru yönetilen ölçütleri seçerek, bunları getirerek ve birincil ölçütü ayrıntılı olarak inceleyerek doğal dil sorusunu yanıtlayın. Açık uçlu teşhis için. metrics:read gerektirir.

Mevcut ekibin tüm mağazalarını listeleyin. İsteğe bağlı durum filtresini, aramayı ve sayfalandırmayı destekler.

Belirli bir mağazanın ayrıntılarını kimliğine göre alın.

Sadakat programı üyelerini listeleyin. Program filtresini ve sayfalandırmayı destekler.

Kimliğe göre belirli bir sadakat üyesinin ayrıntılarını alın. Şifresi çözülmüş kişisel tanımlayıcı bilgileri döndürür.

Kupon havuzlarını listeleyin. Durum ve tür filtrelerini destekler.

Operasyonel kontrol paneli anlık görüntüsü (yakalamalar, taramalar, yakalama oranı, kuponlar, mağazalar, plan). Yönetilen bir ölçüt değildir — yetkili iş ölçütleri için ölçüt araçlarını kullanın.

Ödül sadakati bir üyeye işaret eder. İşlem kimliğini ve yeni bakiyeyi döndürür.

Bir üyeden sadakat puanlarını düşürün (FIFO tüketimi).

Üyenin mevcut puan bakiyesini ve son işlem geçmişini alın.

Bir üyenin mevcut (kullanılmamış, süresi dolmamış) kuponlarını alın.

Üyenin mevcut kademesini, bir sonraki kademe yükseltme gereksinimlerini ve tüm kademelerini alın.

Üyenin makbuz gönderim geçmişini OCR durumu ve verilen puanlarla birlikte alın.

Belirtilen bir havuzdan kupon için sadakat puanlarını kullanın (atomik: puanlar + kupon veya hiçbiri).

Bir üye havuzundan bir kuponu tek bir üyeye verin (toplu kitleler için onay akışı kullanılır). Gereksinimler coupons:write.

Pazarlama e-postasının, belirtilen sıklık sınırları (günde 1, haftada 2, ayda 4) dahilinde bir adrese gönderilip gönderilemeyeceğini kontrol edin.

Sadakat programı için puanlanmış Elçi adaylarını listeleyin (Pro modu). Lite modunda boştur.

Elçi ROI raporunu alın: üç alt hedef, 2. Ay tutma oranı ve 90 günlük devam/durma aşaması.

Bir üyenin kişisel Elçi ortaklık kodunu yayınlayın veya yükseltin. string kodunu döndürür.

Sayfa ziyareti/davranış analizi alın: genel bakış, en çok ziyaret edilen sayfalar, cihaz dökümü veya trafik kaynakları.

Üyenin toplu profili (erişilebilirlik, onay/CCPA(sadakat, ticaret/kategori/kanal/etkileşim özetleri, beyan edilen tercihler, etiketler, genel coğrafi konum, yaş aralığı). Kişisel bilgiler gizlenmiştir — isim veya iletişim bilgileri içermez. Gerektirir members:read.

Kişiselleştirilmiş bir eylem belirlemek için bir üyenin son davranış zaman çizelgesi (ziyaretler, puanlar, kuponlar, e-postalar, makbuzlar) + özeti. Şifresi çözülmüş kişisel verileri döndürür. Gerektirir members:behavior:Okumak.

Ekibin hedef kitle segmentlerini listeleyin (ad, durum, önbelleğe alınmış üye sayısı). Gereksinimler: segments:read.

Yapılandırılmış koşullardan (asla SQL kullanmadan) bir hedef kitle segmenti oluşturun; yinelenenleri reddedin. Gereksinimler: segments:write + Kullanıcıya ait bir anahtar.

Ekibin otomasyonlarını (olay tetiklemeli kampanyalar) ve durumlarını listeleyin. Gereksinimler: automations:read.

Kampanya kimliğine göre çalışan bir otomasyonu duraklatın (idempotent). automations:write gerektirir.

Bu ekip için mevcut kampanya şablonlarını (resmi + kaydedilmiş) listeleyin ve create_campaign_draft için bir template_id bulun. campaigns:read gerektirir.

Taslağı kopyalamak için bir source_campaign_id bulmak üzere ekibin son kampanyalarını (kimlik, başlık, durum) listeleyin. campaigns:read gerektirir.

Şablon veya önceki bir kampanyadan kampanya taslağı oluşturun (ASLA gönderilmez - insan incelemesi gereklidir). Gereksinimler campaigns:write-taslak.

Bir üyenin (herhangi bir sistem) yakın zamanda bir kanalda iletişim kurup kurmadığını kontrol edin — aşırı iletişimi önleyin. members:behavior:read gerektirir.

Bir sadakat programı üyesi oluşturun veya mevcut bir üyeliği aynı şekilde sonlandırın. externalId/e-posta. Pazarlama onayı şu şekilde etkinleştirilmemiştir: MCP. Gereklilikler members:write.

Üye profilini/kimliğini güncelle (e-posta, telefon, vb.) fullName, externalId(Durum). Takım sahipliği uygulanır. Gerektirir members:write.

Bu ekip için externalId ile eşleşen bir mağaza oluşturun veya mevcut mağazayı güncelleyin. stores:write izni gereklidir.

Satın alma siparişini kaydedin ve otomatik olarak puan verin (üye tarafından çözüldü) memberId > externalId > e-posta). Gerektirir orders:write.

Orijinal işlem kimliğine bağlı olarak bir üyeden puanları geri alma (geri çekme) işlemi — POS/ERP iadesi veya iptali için. points:write gerektirir.

Ekibin etiket tanımlarını (anahtar, ad, yaşam döngüsü, kategori, kapsama) listeleyin. Üye etiketlerini okumadan/atamadan önce bir tag_key keşfedin. tags:read gerektirir.

Bir üyenin mevcut etiketlerini alın (anahtar, ad, yaşam döngüsü, değer, kaynak, assignedAt). Gereklilikler members:read.

Üyeye manuel olarak etiket atama işlemi tag_key (Operatör geçersiz kılma; kural taramasına karşı sabitlenmiş). Gerektirir tags:write.

Bir üyeden etiketi tag_key ile manuel olarak kaldırın (canlı bir etiket bir sonraki taramada tekrar eklenebilir). tags:write gerektirir.

Ürünleri kategori/marka/sektör, durum ve kaynak bilgileriyle listeleyin. Duruma göre filtreleyin.category_id/brand_id/dikey. Gerektirir catalog:read.

Varyantları, seri numaralı ürünleri, kombinasyon bileşenleri ve yapay zeka temelli içeriği olan tek bir ürün edinin. Gereksinimler: catalog:read.

Ekibin ürün kategorilerini listeleyin (kimlik, ad, üst kategori). Gereksinimler: catalog:read.

Ekibin markalarını listeleyin (kimlik, isim). Gerekli bilgiler: catalog:read.

En iyi ikinci ürün önerileri: member_id (kişiselleştirilmiş ortak satın alma + kategori yakınlığı) veya product_id (Müşteriler ayrıca şunları da satın aldı). Gerektirir members:read.

Bu ekip için bir sonraki en yüksek öncelikli geri kazanma görevini kiralayın (atomik). Görevi, kiralama son tarihini, üye direniş kolunu ve müşteri kaybı sinyali özetini döndürür. NO_TASKS_AVAILABLE / WINBACK_DISABLED geri döndü isError. Gereklilikler winback:claim.

Sonuçla birlikte (etkinleştirilmiş kaldıraç + not referansı veya BEKLETME nedeni) kiralanmış bir geri kazanma görevini tamamlayın. İdempotent. LEASE_EXPIRED / ALREADY_COMPLETED isError olarak döndürülür. winback:claim gerektirir.

Karar vermeden önce bir üye için tek seferlik salt okunur ön kontrol: onay, e-posta sıklığı payı, yorgunluk, son erişim, müşteri kaybı sinyalleri ve üyenin direnme kolu. Nezaket önizlemesi — sunucu, yazma zamanında her kapıyı uygulamaya devam eder. winback:read gerektirir.

Üye geri kazanım kaydına serbest metinli bir işlem notu ekleyin (gerekçe / gözlemlenen sinyal / karşı tarafın desteklediği hipotez). Metin, talimat olarak değil, VERİ olarak saklanır; maksimum 2000 karakter, temizlenmiş. Gereksinimler winback:write.

Bir teşvikin asla sessiz bir bağış olmaması için yönetilen bir geri kazanma mesajı (gelen kutusu veya e-posta) gönderin. Sunucu tarafında başarısız olan kapılar: WINBACK_DISABLED, görev kiralama sahipliği, HOLDOUT_NO_SEND (bekletme asla mesaj almaz), NOT_CONSENTED, FREQUENCY_CAPPED, CONTENT_REJECTED (temizlenmiş), BREAKER_TRIPPED — isError olarak döndürülür. Mevcut gönderme yığınını yeniden kullanır (abonelikten çıkma altbilgisi + gönderme katmanı tarafından eklenen uyumluluk). winback:write gerektirir.

Müşteri-etkin davranışlarını yakın bir zaman diliminde (Katman 3, en yeniden başlayarak) okuyarak niyeti (Katman 4) çıkarır. Yalnızca kasıtlı müşteri eylemlerini (göz atma, açma/tıklama, giriş yapma, satın alma, kullanma, tavsiye etme, içerik gönderme) katalog etiketi + anlamı satır içi olarak eklenmiş şekilde ve ayrıca bir özet (türe + zaman dilimine göre sayımlar) ile döndürür. Tüm zaman dilimi üzerinden akıl yürütme; niyet, doğrulanması gereken bir hipotezdir, bir gerçek değildir. Sadece okunabilir. winback:read gerektirir.

Bu ekip için bir sonraki temsilci karar görevini kiralayın (atomik; isteğe bağlı olarak türe göre daraltın). Görev kimliği, türü, konu bilgileri ve kiralama son tarihini döndürür. NO_TASKS_AVAILABLE / AGENT_TASKS_DISABLED isError olarak döndü. agent_tasks:claim gerektirir.

Karar vermeden önce bir ajan karar görevinin gerçeklerini (tür, konu, işaretleme nedeni, durum) okuyun. AGENT_TASK_NOT_FOUND isError olarak döndü. agent_tasks:read gerektirir.

Kiralanmış bir görevi, mevcut idempotent yazma işlemleri aracılığıyla etkisini uygulayarak bir kararla tamamlayın. fraud_household_referral: bloke et (her iki taraftan da geri alma) / izin ver (işareti kaldır) / yükselt (insan tarafından müdahale edilmesi için bırak). ALREADY_COMPLETED / NOT_LEASE_OWNER / LEASE_EXPIRED, isError olarak döndürülür. agent_tasks:claim gerektirir.

Bu ekibin üzerinde düşünebileceği iş nesnelerini listeleyin: temel platform nesneleri (üye, sipariş, mağaza, kupon, kampanya, ürün, segment, etiket) artı bu ekibin... MCP-Görünür özel nesneler — anahtar, etiket ve yetkili tek satırlık anlam. Geçerliliği keşfetmek için önce arayın. object Anahtarlar gerektirir. introspection:read.

Bir işletmeyi tanımlayın. object Yönetilen kayıt defterinden: yetkili anlam artı gerçeklere (sütun tabanlı), türetilmiş (yenilik içeren metrik/etiket/toplama referansları - asla bir kalibreyi yeniden türetmeyin) ve özel (bu ekibin özel alanları) olarak bölümlenmiş özellikler. PII özellikleri yalnızca meta verileri döndürür, asla değerleri döndürmez. alanlar=özet (varsayılan) veya tam. Gerektirir introspection:read.

Yönetilen aracı eylemlerini (bir aracının YAPABİLECEĞİ şeyler) listeleyin: hedef objectYan etki, ayar (otomatik/inceleme/yasak), sunucu tarafı ön koşul anahtarları, değer sınırı ve geri alınabilirlik — yazma önerisinde bulunmadan önce kendi kendini kontrol et. İsteğe bağlı olarak filtrele. object. Gereklilikler introspection:read.

Takımın pul kartını listeleyin (eStampProgram bilgileri: kimlik, isim, tamamlanması gereken pul sayısı, ödül türü (kupon/puan/manuel), otomatik sıfırlama ve durum. Lütfen önce arayarak bilgi alın. program_id. Gereklilikler stamp:read.

Üyenin aktif damga kartlarını edinin: program adı, mevcut damgalar, gerekli damgalar, şu ana kadar tamamlananlar ve ödül. Gereksinimler: stamp:read.

Bir üyeye damga programı (örneğin mağaza ziyareti) için damga verin. idempotency_key ile idempotent; kart tamamlandığında ödül (kupon/puan) otomatik olarak verilir. Çağrı başına miktar sınırlıdır. stamp:write gerektirir.

Bir üyenin puanları: harcanabilir bakiye, ömür boyu kazanılan, kullanımlar, mevcut kademe, en kısa sürede sona erecek parti. Üyeye bağlı anahtar → kendi puanları (member_id'yi atla); takım anahtarı → member_id'yi geçir. loyalty:self:read gerektirir.

Bir üyenin son puan işlemleri (kazanılan/kullanılan/ayarlanan), en yeniden başlayarak. Üyeye bağlı anahtar → kendi geçmişi; ekip anahtarı → member_id'yi geçirin. loyalty:self:read gerektirir.

Üyelerin puanlarıyla satın alabileceği ödüller — puan maliyetlerini gösteren katalog, üyenin bakiyesine göre ödeme gücüne göre işaretlenmiştir. Üyeye özel anahtar → kendi anahtarınız; takım anahtarı → geçiş kartı member_id. Gereklilikler loyalty:self:Okumak.

Sadakat programının nasıl çalıştığı — kazanma oranı, hoş geldin bonusu, puan değeri, nasıl katılacağınız — ayrıca marka onaylı SSS. Herkese açık bilgiler. Üyeye bağlı anahtarın argümana ihtiyacı yoktur. loyalty:self:read gerektirir.

Sentetik panel simülasyon senaryolarını, her birinin gerçek kullanılabilirlik sınırını, güven aralığını ve giriş alanlarını listeleyin. Öncelikle bir tür seçmek için iletişime geçin. Gereksinimler metrics:read.

Markanın sentetik panel kalibrasyonu (geçmiş sentetik tahminlerin gerçekliğe göre isabet oranı; null (Geriye dönük testler yapılana kadar). Gerektirir metrics:read.

Sentetik panel çalışması için dondurulmuş dürüst raporu okuyun — yönlendirmeli okuma, güven tavanı, baskı işaretleri, temalar — veya blockReason Hazır değilse. Gerektirir metrics:read.

Sentetik bir panel çalıştırın: Bir segmentin kimliksizleştirilmiş dijital ikizleri bir uyarıcıya tepki verir ve dürüst bir yönlendirme raporu üretir (asla gerçek mutlak sayılar değil). Bir sonuç döndürür. run_id Anket yapmak için. Günlük koşu sınırı + ≤50 ikiz ile sınırlıdır. Gereksinimler synthetic:write.