OneTrace.pro Yardım merkezi

Mağazalar ve mağaza içi satışlar

Mağazalarınızdaki alışverişleri çevrim içi verilerle birlikte OneTrace.pro platformuna aktarabilirsiniz. Kasadaki fiş, müşterinin profiline site ziyaretlerinin, ürün görüntülemelerinin ve e-postalarının yanına eklenir. Buradan ROPO raporu çıkar: mağaza satışlarının kaçı, daha önce ürünü çevrim içi araştıran müşterilerce yapıldı. Mağaza alışverişleri segmentlerde ve yolculuklarda da kullanılabilir.

Bölüm Veriler → Mağazalar menüsündedir. Bölümü ürünleri görüntüleme yetkisi olan roller görebilir; kuralı ve listeyi ürünleri değiştirme yetkisi olan roller değiştirebilir.

“Mağazalar” bölümü: mağaza alışverişi kuralı, noktalara göre fişler ve liste

Mağaza alışverişi nasıl ayırt edilir

Mağaza fişi, sitedeki siparişle aynı satın alma olayıdır; örneğin tutarı ve ürünleri olan order_completed. OneTrace.pro bunu çevrim içi siparişten ayırabilsin diye fişte ayrı bir özellik bulunur. Kural, Mağaza içi satın alma nasıl ayırt edilir bloğunda belirlenir:

  • Satın alma olayı özelliği (varsayılan): fiş, channel özelliği ve offline değeriyle satın alma olayı olarak gönderilir. Özellik ve değer değiştirilebilir. Satın alma olayı tahmin ayarlarından alınır.
  • Ayrı olay: fişler zaten kendi olaylarıyla geliyorsa, örneğin store_purchase, onu seçin.
  • Mağaza kimliği özelliği (varsayılan store_id), fişi listedeki satış noktasına bağlar.

Kural her yerde hemen geçerli olur: ROPO raporu, segment koşulu, yolculuk tetikleyicisi ve fiş dosyası yükleme.

Fişler nasıl gönderilir

Fişin müşterisi telefona, e-postaya veya sadakat kartı numarasına göre belirlenir. Bunlarla bir profil yoksa yenisi oluşturulur. Müşteri sitede aynı telefonu veya e-postayı bıraktığında profiller birleşir ve çevrim içi geçmişi mağaza alışverişleriyle bağlanır; bkz. Profillerin birleştirilmesi. Telefonu, e-postası ve kartı olmayan fiş çevrim içi geçmişle ilişkilendirilemez, bu yüzden rapor için işe yaramaz.

Dört yol vardır:

Yol Ne zaman uygun
1C eklentisi 1C:Retail, 1C:Small Business Management veya 1C:Trade Management fişleri; otomatik olarak her 15 dakikada bir
API istek gönderebilen kendi kasanız veya muhasebe sisteminiz
Mağaza fişleri şablonlu veri kaynağı sistemin her gece dosya olarak koyduğu fiş dışa aktarımı; bkz. Veri kaynakları
Dosya yükleme geçmiş döneme ait fişlerin tek seferlik yüklenmesi; örneğin kasayı bağlamadan önce raporu görmek için

Hangi yolu seçerseniz seçin, aynı fişin bir gün içinde yeniden gönderilmesi kopya oluşturmaz.

1C eklentisi

1C:Retail 2.3 ve 3.0, 1C:Small Business Management (UNF) 1.6 ve 3.0, 1C:Trade Management 11 için yapılandırma eklentisi; 1C:Enterprise 8.3.21 ve daha yeni platform gerekir. Yapılandırma değişmez: her şey eklentidedir.

  • Her 15 dakikada bir yeni işlenmiş “Чек ККМ” fişlerini gönderir: tarih, numara, mağaza, tutar ve ürünler. Müşteri, fişteki telefon, e-posta ve sadakat kartıdır.
  • Günde bir kez mağaza listesini gönderir.
  • Müşterisi olmayan fiş atlanır ve nedeniyle birlikte kayıt günlüğüne yazılır. Diğer fişler gönderilir.
  • OneTrace.pro erişilemezse veya anahtar yanlışsa fişler kaybolmaz: sonraki çalıştırmada gönderilir.

Fiş dosyası yükle bölümünde 1C eklentisi bağlantısı varsa, eklentiye ve kurulum ile ayar talimatına oradan ulaşabilirsiniz. Eklenti için “Ürün yükleme ve silme” yetkisine sahip gizli bir API anahtarı gerekir: bu yetki mağaza listesi için gereklidir. Eklentinin ayar işleme formunda OneTrace.pro adresini ve anahtarı girin, bağlantıyı kontrol edin ve ayarları kaydedin.

Fişteki ürün, ürün çeşidinin stok kodu, kodu veya benzersiz tanımlayıcısıyla gönderilir. Ayarlarda katalogdaki ürün kimlikleriyle eşleşeni seçin. Aksi halde ROPO raporu müşterinin sitede baktığı ürünleri bulamaz.

API

Fişi gizli anahtarla track olayı olarak gönderin. Müşteri context.traits içinde iletilir, userId gerekmez:

{
  "event": "order_completed",
  "messageId": "check-ber01-000123",
  "timestamp": "2026-10-29T15:04:00+01:00",
  "properties": {
    "channel": "offline",
    "store_id": "BER-01",
    "order_id": "000123",
    "amount": 89.90,
    "products": [{ "product_id": "SKU-1", "price": 89.90, "quantity": 1 }]
  },
  "context": { "traits": { "phone": "+49 151 2345 6789", "loyalty_card": "2770 0001 5002" } }
}
  • İstek POST /api/v1/track, toplu gönderim POST /api/v1/batch; bkz. Sunucu entegrasyonu.
  • Müşteriyi context.traits ile yalnızca gizli anahtarlı istekler bulur. Sitenin kayıt anahtarıyla bu yapılamaz: aksi halde bir ziyaretçi kendini başkasının telefonuyla tanıtabilirdi.
  • messageId fişin kalıcı kimliğidir; örneğin mağaza ve fiş numarası. Aynı messageId ile yapılan tekrar atılır.
  • Müşteri sitede kişisel hesabına girdiyse ve kasa onun kimliğini biliyorsa userId de gönderin.

Mağazalar, POST /api/v1/stores isteğiyle ve {"items": [{"id": "BER-01", "name": "Berlin Mitte", "city": "Berlin", "address": "…"}]} gövdesiyle listeye aktarılır: tek seferde en fazla 1000 nokta; aynı kimlikli nokta güncellenir. “Ürün yükleme ve silme” yetkisi gerekir.

Fiş dosyası yükleme

  1. Veriler → Mağazalar bölümünde Fiş dosyası yükle bloğundaki Dosya seç düğmesine tıklayın. 50 MB'a kadar CSV veya 10 MB'a kadar Excel (.xlsx, .xls, ilk sayfa) uygundur. İlk satırda sütun adları olmalıdır.
  2. Her sütunda ne olduğunu belirtin: fişin tarihi ve saati (zorunlu), telefon, sadakat kartı, e-posta veya müşteri kimliği (en az bir sütun), mağaza, fiş numarası, tutar, ürünler. Benzer adlı sütunlar kendiliğinden eşleşir. Gereksiz sütunları atlayın, diğerlerini fişin özellikleri olarak kaydedebilirsiniz.
  3. Fişleri yükle düğmesine tıklayın. Yüklemenin ilerleyişi ve satır hataları sayfada görünür. Son yüklemeler formun altında gösterilir.

Fiş dosyası yükleme: sütunların atanması

  • Saat dilimi olmayan saat, örneğin 2026-10-28 18:42 veya 28.10.2026 18:42, projenin saati sayılır: kasa genellikle yerel saati yazar.
  • Tek hücredeki ürünler ;, , veya | ile ayrılır.
  • Her satır, mağaza alışverişi kuralına göre bir fiş olur. Müşterisi olmayan satır hatayla atlanır.
  • Yükleme, profilleri değiştirme yetkisi olan rollere açıktır. Yüklenen fişler tarifenin aylık olay kotasına sayılır.

Mağaza listesi

Liste, satış noktalarına ROPO raporunda fişlerdeki kimlikler yerine anlaşılır adlar verir. Bir mağazanın Mağaza kimliği (fişlerdeki store_id değeri), Ad, Şehir ve Adres alanları vardır. Mağazayı Mağaza ekle düğmesiyle, API ile veya 1C eklentisiyle ekleyebilirsiniz.

Son 30 günün fişleri bloğu, her noktada kaç fiş ve müşteri olduğunu ve son fişin ne zaman geldiğini gösterir. Listede olmayan nokta “Listede yok” olarak işaretlenir; Adlandır düğmesi onu ekler. Mağazayı silerseniz fişleri kalır, raporda ad yerine kimlik görünür.

Segmentler ve yolculuklar

  • Mağaza alışverişi segment koşulu, son N günde mağazadan alışveriş yapan müşterileri seçer. “Fişten önceki çevrim içi temaslar” alanı: “Herhangi” tüm müşteriler, “Çevrim içi temastan sonra” veya “Çevrim içi temas olmadan”. Temas penceresini, türlerini ve mağazayı seçebilirsiniz. Bkz. Segmentler.
  • Mağaza alışverişi yolculuk tetikleyicisi, mağazadan gelen her fiş için yolculuğu başlatır. Mağazayı ve en düşük tutarı sınırlayabilirsiniz; örneğin mağaza için puan istemek veya alışverişe uygun ürünler önermek için. Bkz. Yolculuklar.