12Entegrasyonlar ve veriler

Çevrimdışı etkinlikler

CRM anlaşmalarını, ödemeleri ve aramaları Gauss'a gönderme ve talebin reklam kampanyasına bağlama: sipariş veya talep kimliğiyle ya da CRM'deki atıfla.

Çevrimdışı etkinlikler site dışında olanlardır: satış temsilcisi bir talebi nitelendirdi, müşteri faturayı ödedi, siparişini teslim aldı veya yorum bıraktı. Bunları sizin sunucunuz gönderir (CRM, mağaza arka ucu, Zapier veya n8n); Gauss da kanal ve kampanyaya göre geliri ve "talep → müşteri" dönüşümünü gösterir.

Yakında. Çevrimdışı etkinlik API'si henüz yayında değil. Aşağıda nasıl çalışacağı anlatılıyor. İstek biçimi yayından önce değişebilir.

Neden gerekli

Site yalnızca talebi görür. Para daha sonra, CRM'de gelir: bir gün, bir hafta veya bir ay sonra. Çevrimdışı etkinlikler olmadan hangi kampanyanın talep getirdiğini görürsünüz, ama hangisinin müşteri ve gelir getirdiğini göremezsiniz. Çevrimdışı etkinlikler bu boşluğu kapatır:

CRM anlaşmaları dahil gelir ve ROMI;
kampanyalara göre talep hunisi: talep → nitelikli → müşteri;
yalnızca talep başına değil, müşteri başına maliyet;
kanallara göre yorum sayısı ve ortalama puan.

Etkinlik reklama nasıl bağlanır

Gauss'ta bir kişiyi bir günden uzun süre tanıyan bir tanımlayıcı yoktur; bu yüzden beş gün sonraki bir anlaşma, GA4'ün çerezle yaptığı gibi ziyarete bağlanamaz. Bağlantıyı CRM taşır. İki yol vardır.

Sipariş veya talep kimliğiyle — ana yol

Sitedeki dönüşümün CRM'in bildiği bir kimliği varsa, CRM'de ek bir şey saklamanız gerekmez.

Sitede talebi CRM kimliğiyle lead_id içinde gönderin (veya satın almayı transaction_id ile):
js
```
gauss('event', 'generate_lead', { lead_id: 'L-58213' });
```
Gauss bu dönüşümün kanalını, UTM etiketlerini ve giriş sayfasını hatırlar. Kimliğin kendisi saklanmaz, yalnızca hash'i.
CRM'de bir şey olduğunda sunucunuz etkinliği aynı lead_id veya transaction_id ile gönderir. Gauss dönüşümü hash'e göre bulur ve atıfı oradan alır.

Bağlantı 90 gün geçerlidir. Çevrimdışı etkinlik daha geç gelirse veya kimlik bulunamazsa ve etkinlikte attribution alanı yoksa "Bilinmiyor" kanalına düşer.

CRM'den atıf

Sitede kimlik yoksa veya dönüşüm sitede gerçekleşmediyse (örneğin bir telefon araması), talebin atıfını CRM saklar ve etkinliğin attribution alanında gönderir: kanal, UTM etiketleri, giriş sayfası ve kategorisi.

Yakında. Gizli form alanları için mevcut ziyaretin atıfını döndüren gauss.attribution() izleyici fonksiyonu. Kişi birkaç sayfa gezse bile ziyaretin ilk sayfasındaki etiketler kaybolmaz.

Bir etkinlikte hem kimlik hem attribution varsa, kimlikle bulunan atıf önceliklidir.

İstek biçimi

Biçim yayından önce değişebilir.

POST https://app.gausslab.io/api/v1/offline-events — yalnızca sunucudan, Authorization: Bearer … başlığında site belirteciyle. Bir istekte en fazla 500 etkinlik.

json

{
  "events": [
    {
      "name": "close_convert_lead",
      "occurred_at": "2026-10-30T14:05:00Z",
      "idempotency_key": "crm-deal-58213-won",
      "params": { "value": 20000, "currency": "TRY", "lead_id": "L-58213" }
    },
    {
      "name": "submit_review",
      "occurred_at": "2026-11-02T09:00:00Z",
      "idempotency_key": "review-9921",
      "params": { "rating": 5 },
      "attribution": { "channel": "social", "utm_source": "instagram", "utm_campaign": "oct_promo" }
    }
  ]
}

Yanıt, her etkinlik için sonuçla birlikte 202 olur: accepted, duplicate veya nedeniyle birlikte rejected.

Alan	Kural
`name`	etkinlik adı — aşağıdaki listeden veya genel ad kurallarına uyan kendi adınız
`occurred_at`	etkinliğin gerçekleştiği zaman; 90 günden eski ve 1 saatten ileri olamaz
`idempotency_key`	zorunlu; aynı anahtarla tekrar ikinci bir etkinlik oluşturmaz ve `duplicate` döner
`params`	site etkinliklerindeki gibi; gelir için `value` ve `currency`, yorumlar için 1–5 arası `rating`
`params.transaction_id`, `params.lead_id`	sitedeki dönüşüme bağlamak için sipariş veya talep kimliği; yalnızca hash olarak saklanır
`attribution`	CRM'den atıf alanları; kimlik yoksa gerekir; kısmen gönderilebilir

Idempotency sayesinde ağ hatasından sonra isteği güvenle tekrarlayabilirsiniz: aynı idempotency_key ile gelen etkinlik geliri ikiye katlamaz.

Etkinlik adları

Talepler için GA4 sözlüğünü kullanın:

Etkinlik	Ne zaman gönderilir
`qualify_lead`	talep nitelendirildi
`disqualify_lead`	talep reddedildi
`working_lead`	talep üzerinde çalışılıyor
`close_convert_lead`	talep müşteriye dönüştü
`close_unconvert_lead`	anlaşma satın alma olmadan kapandı

Satın almalar için purchase ve refund. Kendi etkinlikleriniz genel kurallara uyar, örneğin submit_review veya order_delivered.

Gönderilmemesi gerekenler

E-posta, telefon, ad, user_id, client_id, e-posta veya telefon hash'leri ve kişiye ait diğer tüm tanımlayıcılar. Bu alanları içeren istek sessizce temizlenmez, bütünüyle reddedilir (rejected: personal_data); böylece entegrasyon hemen düzeltilebilir. Reddedilen etkinlikler hata ayıklamada görünür.

Gauss ne saklar

Çevrimdışı etkinlik hiçbir ziyarete bağlanmaz: atıfla birlikte ayrı bir kayıt olarak saklanır — kanal, kampanya ve giriş sayfası, site içindeki yol olmadan. Sipariş veya talep kimliği yalnızca hash olarak saklanır. Raporlar topludur: belirli bir siparişin verileri ne panelde ne de API üzerinden görüntülenebilir. Veriler hakkında daha fazlası — Hangi veriler toplanır.

Güncellendi: 29 Ekim 2026