Müşteriler & İndirimler API
Farklı pazaryerlerinden ve e-ticaret sitenizden alışveriş yapan müşterilerinizi tekilleştirilmiş profiller halinde CRM sisteminize aktarın; kupon ve kampanya performanslarını analiz edin.
Kanallar Arası Müşteri Tekilleştirme
Aynı müşterinin hem Shopify sitenizden hem de Trendyol veya Hepsiburada mağazanızdan verdiği siparişler Armonika tarafından tek bir cus_... profili altında birleştirilir:
- • Normalize edilmiş cep telefonu numarası ve gerçek e-posta adresi birincil eşleştirme anahtarıdır (pazaryerlerinin ürettiği geçici relay e-postalar kimlik birleştirmede yoksayılır).
- • total_spent ve orders_count metriklerine iptal edilen (cancelled) ve iade edilen (returned) siparişler dahil edilmez.
/v1/customersMüşterileri Listele
Mağazanın tüm satış kanallarında tekilleştirilmiş müşteri profillerini, toplam sipariş sayılarını ve net harcama tutarlarını (iptal/iade hariç) imleçli olarak döndürür.
İstek Parametreleri
| Alan | Konum | Tip | Zorunluluk | Açıklama |
|---|---|---|---|---|
| q | Query | string | Opsiyonel | Ad soyad, e-posta veya telefon numarası ile müşteri araması. |
| channel | Query | string | Opsiyonel | Belirli bir kanaldan alışveriş yapmış müşterileri filtrele. |
| cursor | Query | string | Opsiyonel | Sayfalama imleci. |
| limit | Query | integer (1–100) | Vars: 50 | Sayfa boyutu. |
/v1/customers/v1/customers/{customer_id}Tekil Müşteri Detayını ve Kanal Kırılımını Getir
Müşterinin iletişim bilgilerini, kanal bazında sipariş/harcama dağılımını, son siparişlerini ve kullandığı kupon/indirim kodlarını döndürür.
İstek Parametreleri
| Alan | Konum | Tip | Zorunluluk | Açıklama |
|---|---|---|---|---|
| customer_id | Path | string | Zorunlu | Armonika müşteri kimliği (örn. cus_01JB8W4X9Z1A3C5E7G9). |
/v1/customers/{customer_id}/v1/discountsKampanya ve İndirim Kırılımlarını Listele
Siparişlerde uygulanan kupon kodlarını, satıcı bütçeli kampanyaları (seller) ve pazaryerinin kendi bütçesinden karşıladığı indirimleri (platform) kullanım adedi ve toplam tutarlarıyla döndürür.
İstek Parametreleri
| Alan | Konum | Tip | Zorunluluk | Açıklama |
|---|---|---|---|---|
| source | Query | 'seller' | 'platform' | 'coupon' | Opsiyonel | İndirim kaynağı filtresi. |
| channel | Query | string | Opsiyonel | Satış kanalı filtresi. |
| start_date | Query | ISO 8601 datetime | Opsiyonel | Başlangıç tarihi. |
| end_date | Query | ISO 8601 datetime | Opsiyonel | Bitiş tarihi. |
/v1/discounts
