WebHooks
Settings > WebHooks > Create New WebHook
WebHooks Netmera ile daha geniş dijital ekosistem arasında köprü görevi gören bir iletişim kanalıdır. Netmera merkeziniz ile harici uygulamalar arasında gerçek zamanlı olarak içgörüler, tetikleyiciler ve aksiyonlar taşıyan sanal bir haberci gibi düşünebilirsiniz.
Bu nedenle, şu işlevi görür: Netmera'dan bir harici web uygulamasına veya servisine bilgiyi gerçek zamanlı olarak göndermenize olanak tanır. Netmera uygulamanızı diğer sistemlerle entegre etmenin bir yoludur ve Netmera'daki belirli Event’ler veya veri değişikliklerine bağlı olarak harici uygulamanızda aksiyon tetiklemenizi sağlar.
aralığındadır.
Örneğin, Netmera'dan gönderilen push bildirimleriyle kullanıcı etkileşimlerini takip edip analiz etmek istediğinizi varsayalım. Bir WebHook oluşturabilir ve bu WebHook, bir kullanıcı push bildirime tıkladığında tetiklenir (Push Click event). Bu WebHook daha sonra tıklama event'i ile ilgili verileri daha fazla analiz ve raporlama için harici bir analitik sistemine gönderebilir.
Create New WebHook
WebHook Adı
Netmera Control Panel ve raporlar içinde WebHook'u tanımlamak için kullanıcı tarafından belirlenen bir isim. Bu ad organizasyon amaçlı kullanılır ve WebHook'un fonksiyonunu etkilemez.
WebHook URI
Netmera'nın WebHook verilerini göndereceği URL (Uniform Resource Identifier). Bu URL, WebHook verilerini alacak harici web uygulaması veya servisin endpoint'ine işaret etmelidir. (Yer tutucuda gösterildiği gibi parametreleri parantez içinde gösterin. Parametreler doğrulandıktan sonra, bildirim hazırlanırken kullanılacak karşılık gelen etiketleri girmeniz gerekecektir.)
İstek Yöntemi
WebHook isteği gönderilirken kullanılacak HTTP yöntemi. Bu örnekte, GET, belirtilen URI'ye HTTP GET isteği ile WebHook'un tetikleneceği anlamına gelir.
Trigger
WebHook'u tetikleyecek event veya aksiyon türü. Bu örnekte, mevcut seçenekler şunlardır:
Push Click: Bir kullanıcı push bildirime tıkladığında WebHook tetiklenecektir.
Message Log: Bir mesaj günlük (Message Log) olayı meydana geldiğinde WebHook tetiklenecektir.
Geofence: Bir geofence olayı tespit edildiğinde WebHook tetiklenecektir.
Select Event
Eğer Event tetik tipi olarak seçildiğinde, bu alan WebHook'u tetikleyecek belirli bir event'i (ör. belirli bir push bildirimi veya geofence) seçmenize olanak tanır.
Example:
Belirli ürün kategorileriyle kullanıcı etkileşimlerini izlemek isteyebilirsiniz. Bir kullanıcı ürün detay ekranını görüntülediğinde tetiklenen bir WebHook kurabilirsiniz. Ardından "Context Parameter" seçeneğini kullanarak görüntülenen ürünün bağlamından alınan ürün kategorisini bir header değeri olarak ekleyebilirsiniz. Böylece WebHook'u alan harici sistem, farklı ürün kategorilerine yönelik kullanıcı ilgi düzeylerini analiz edebilir.
WebHook Header'ları
Bunlar WebHook isteğine dahil edilebilen HTTP header'larıdır. Harici uygulamanın işlemesi için ek bilgi veya yetkilendirme verisi taşıyabilirler.
Context Parameter: Bir header için "Context Parameter" seçeneği kullanıldığında, header'ın değeri WebHook'u tetikleyen belirli event'in bağlamından alınır. Bağlam, kullanıcının profil özelliği, cihaz özelliği veya event'e özgü başka ilgili veri olabilir. Bu, event'e bağlı dinamik bilgi geçmenizi sağlar.
Fixed Value: Bir header için "Fixed Value" seçeneği kullanıldığında, her WebHook isteğinde header değeri olarak gönderilecek statik bir değer sağlarsınız. Bu, WebHook'u tetikleyen spesifik event ne olursa olsun aynı değerin kullanılacağı anlamına gelir. Header değerinin tüm WebHook istekleri için sabit olduğu durumlarda faydalıdır.
Anahtar: Header parametresinin adı.
Değer Kaynağı: Header parametresinin değerinin nasıl belirleneceğini belirtir. Değer, kullanıcının profil özelliğinden, cihaz özelliğinden veya sabit bir değerden alınabilir.
Değer: Header parametresinin gerçek değeri.
Sizin
Bazı durumlarda, WebHook isteklerini kimlik doğrulamanız gerekebilir; istek header'larına bir API anahtarı veya kimlik doğrulama token'ı ekleyerek. Bu senaryoda, API anahtarı veya token'ı header içinde statik bir değer olarak sağlamak için "Fixed Value" seçeneğini kullanabilirsiniz. Bu, hangi event'lerin tetiklediğinden bağımsız olarak tüm WebHook isteklerinin gerekli kimlik doğrulamasını taşımasını sağlar.
WebHook Parametreleri
Bunlar WebHook isteğine dahil edilebilen ek parametrelerdir. Header'lar gibi, tetikleyen event ile ilgili spesifik verileri taşıyabilirler.
Anahtar: Parametrenin adı.
Değer Kaynağı: Parametrenin değerinin nasıl belirleneceğini belirtir. Değer, kullanıcının profil özelliğinden, cihaz özelliğinden veya sabit bir değerden alınabilir.
Değer: Parametrenin gerçek değeri.
Örnek İstek
Bir örnek istek, WebHook isteğinin nasıl yapılacağını gösteren bir cURL komutu olarak sağlanır. ${hook.url} istek gönderildiğinde gerçek WebHook URI'si ile değiştirilecek bir yer tutucudur.
Genel olarak, Netmera'da bir WebHook oluşturmak, uygulamanızın işlevselliğini diğer servislerle entegre ederek genişletmenizi, iş akışlarını otomatikleştirmenizi ve kullanıcı davranışı hakkında daha derin içgörüler elde etmenizi sağlar.
Last updated
Was this helpful?