Web kancaları ne yapar
Bir web kancası belirli bir mağaza olayına abone olur. O olay gerçekleştiğinde Storeep, olay verilerini hemen belirttiğiniz bir URL'ye (API türü) veya belirttiğiniz bir e-posta adresine (E-posta türü) gönderir. Web kancaları genellikle sipariş takibi entegrasyonları, CRM eşitlemeleri, reklam platformu dönüşümleri ve otomatik bildirimler için kullanılır.
Web kancalarını yönetmek için Ayarlar → Web kancaları bölümüne gidin. Web kancalarını görüntülemek veya değiştirmek için ayarlar iznine ihtiyacınız vardır.
Web kancası sınırları
- Mağaza başına en fazla 20 web kancası. 21'inciyi eklemeye çalışmak "Mağaza başına en fazla 20 web kancası sınırına ulaştınız" hatasını döndürür.
- Liste, web kancalarını en yeniden eskiye, sayfa başına 40 olarak gösterir.
Web kancası oluşturma
Yeni web kancası ekle'ye tıklayın, aşağıdaki alanları doldurun, ardından Ekle'ye tıklayın.
Etkinleştir
Varsayılan olarak işaretlidir. İşaretliyken web kancası, kaydettiğiniz anda çalışır ve eşleşen olaylar gönderilir. Web kancasını hiçbir şey almayan devre dışı bir durumda kaydetmek için işareti kaldırın. Bunu web kancasını düzenleyerek istediğiniz zaman değiştirebilirsiniz.
Ad
- Zorunlu. En fazla 50 karakter.
- Listede gösterilen açıklayıcı bir etiket, örneğin Facebook CAPI sipariş oluşturuldu.
Tür
- API: Storeep, olay verilerini taşıyan bir HTTP POST isteğini URL'nize gönderir.
- E-posta: Storeep, olay verilerini içeren bir e-postayı adresinize gönderir.
Olay
Web kancasını tetikleyen mağaza olayı. Üç olay vardır:
- Oturum oluşturuldu: mağazanızda yeni bir ziyaretçi oturumu oluşturulur.
- Sipariş oluşturuldu: yeni bir sipariş verilir.
- Sipariş güncellendi: mevcut bir siparişin durumu veya verisi değişir.
Önemli: E-posta türü yalnızca Sipariş oluşturuldu ve Sipariş güncellendi olaylarını teslim eder. E-posta'yı Oturum oluşturuldu ile seçerseniz web kancası kaydedilir ama hiçbir şey göndermez. Oturum olayına ihtiyacınız varsa API türünü kullanın.
Biçim
Tek bir seçenek, Json: veri yükü bir JSON belgesi olarak gönderilir.
URL (yalnızca API türü)
- Tür API olduğunda zorunludur. En fazla 500 karakter.
- Alan sizin için bir
https://öneki gösterir, bu yüzden yalnızca ana bilgisayarı ve yolu girin, örneğinapi.example.com/events/order. Tam birhttps://veyahttp://adresi yapıştırırsanız önek kaydetmeden önce kaldırılır. - Dinamik yer tutucular: olay verilerindeki herhangi bir alanı çift süslü parantez söz dizimiyle
{{field_name}}URL'ye ekleyin. Örnek:example.com/postback?cid={{fbclid}}&payout={{order_total}}. Değerler URL kodlamalıdır ve alanı eksik olan bir yer tutucu boş bir değere dönüşür. Bu, dönüşüm verilerini bir aracı olmadan doğrudan bir reklam platformuna göndermenizi sağlar. - Adres, yer tutucular kaldırıldıktan sonra doğrulanır, bu yüzden geçersiz bir URL "Girdiğiniz url hatalı" hatasını döndürür.
E-posta adresi (yalnızca E-posta türü)
- Tür E-posta olduğunda zorunludur. Geçerli bir adres olmalı, en fazla 127 karakter.
Web kancası düzenleme
Düzenleyiciyi açmak için herhangi bir satıra tıklayın. Her alan düzenlenebilir. URL alanı yalnızca kayıtlı tür API olduğunda önceden doldurulur, e-posta alanı ise yalnızca kayıtlı tür E-posta olduğunda önceden doldurulur. Uygulamak için Kaydet'e tıklayın. Etkinleştir işaretli değilken kaydetmek, web kancasını silmeden devre dışı bırakır.
Web kancaları listesi sütunları
- Ad: etiket ve oluşturulma tarihi.
- URL / E-posta: hedef.
- Tür: API veya E-posta.
- Olay: Oturum oluşturuldu, Sipariş oluşturuldu veya Sipariş güncellendi.
- Biçim: Json.
- Durum: Etkin veya Devre dışı.
Web kancası silme
Bir veya daha fazla satır seçin ve Web kancalarını sil'e tıklayın. Silme işlemi kalıcıdır ve o abonelik için gelecekteki tüm teslimatları durdurur.
Teslimat, yeniden denemeler ve başarısızlık e-postaları
Bu bölüm API web kancaları için geçerlidir. E-posta web kancaları gönder ve unut mantığıyla çalışır: bir kez gönderilir, yeniden deneme yapılmaz ve başarısızlık takibi yapılmaz.
Yeniden deneme davranışı
- Her isteğin 5 saniyelik bir zaman aşımı vardır. Bir hedef 5xx hatası, 429 (hız sınırlı) döndürürse veya ulaşılamazsa (bağlantı hatası), teslimat geçici bir başarısızlık olarak değerlendirilir ve yeniden denenir.
- İlk teslimat başarısız olduktan sonra Storeep, 5 yeniden denemeye kadar üstel aralıkla tekrar dener: yaklaşık 30sn, 60sn, 120sn, 240sn, ardından 480sn sonra. Son yeniden denemeden sonra olay düşürülür.
- 429 dışındaki bir 4xx yanıtı (örneğin 404 veya 403) kalıcı bir başarısızlık olarak değerlendirilir. Storeep bunu yeniden denemez, çünkü yanlış veya reddeden bir uç nokta kendi kendini düzeltmez.
- Aynı olayda birden çok web kancanız olduğunda, bir yeniden deneme yalnızca başarısız olanlara tekrar gönderir. Zaten başarı döndüren uç noktalar atlanır, böylece yinelenen teslimatlar almazsınız.
Başarısızlık bildirimi e-postası
- Storeep, web kancası başına ardışık başarısız teslimatları sayar. 5 ardışık başarısızlıktan sonra mağaza sahibi, sahibin dilinde "İşlem gerekli: Storeep web kancanız başarısız oluyor" başlıklı tek bir e-posta alır; bu e-posta web kancası adını, hedefi, olayı ve son HTTP durum kodunu listeler.
- Her başarısızlık dizisi için tam olarak bir e-posta alırsınız. O web kancası toparlanana kadar başka e-posta gönderilmez.
- Bir teslimat yeniden başarılı olur olmaz başarısızlık sayacı sıfıra döner ve bildirim yeniden devreye alınır, böylece gelecekteki bozuk bir dizi size tekrar e-posta gönderebilir.
İpuçları ve tuzaklar
- Aynı olay için birden çok web kancası oluşturabilirsiniz, örneğin Sipariş oluşturuldu olayını iki ayrı kayıt olarak hem bir CRM'ye hem de bir reklam platformuna gönderin.
- Uç noktanız kimlik doğrulama gerektiriyorsa, URL sorgu dizesine bir belirteç koyun, ya sabit olarak ya da olay verilerinden bir
{{placeholder}}aracılığıyla, ya da iletmeden önce kimlik doğrulamayı ekleyen bir aracı kullanın. - Oturum oluşturuldu, her benzersiz ziyaretçi oturumu için tetiklenir ve yoğun mağazalarda yüksek hacimli olabilir. Yalnızca uç noktanız bu hacmi kaldırabiliyorsa abone olun ve yalnızca API türüyle çalıştığını unutmayın.