WebHook'lar
Ayarlar > WebHooks > Yeni WebHook Oluştur
WebHooks Netmera ile daha geniş dijital ortam arasındaki köprünüz olarak ortaya çıkar. Netmera merkeziniz ile harici uygulamalar arasında içgörüler, tetikleyiciler ve eylemler taşıyan sanal bir haberci olduğunu hayal edin; üstelik hepsi gerçek zamanlı olarak.
Bu nedenle, bir mekanizmadır Netmera'dan harici bir web uygulaması veya servisine gerçek zamanlı olarak bilgi göndermenizi sağlar. Netmera uygulamanızı diğer sistemlerle entegre etmenin bir yoludur ve Netmera'daki belirli event veya veri değişikliklerine dayanarak harici uygulamanızda eylemler tetiklemenizi sağlar.
İpucu:
Örneğin, Netmera'dan gönderilen push bildirimleriyle kullanıcı etkileşimlerini takip etmek ve analiz etmek istediğinizi varsayalım. Bir WebHook oluşturabilirsiniz; bu WebHook, bir kullanıcı bir push bildirime tıkladığında tetiklenir (Push Click event). Bu WebHook daha sonra tıklama eventine dair verileri daha ileri analiz ve raporlama için harici bir analiz sistemine gönderebilir.
Yeni WebHook Oluştur
WebHook Adı
WebHook'u Netmera Kontrol Paneli ve raporlarda tanımlamak için kullanıcı tarafından belirlenen bir isim. Bu isim organizasyon amaçlıdır ve WebHook'un çalışmasını etkilemez.
WebHook URI
Netmera'nın WebHook verisini göndereceği URL (Uniform Resource Identifier). Bu URL, WebHook verisini alacak harici web uygulamasının veya servisin endpoint'ine işaret etmelidir. (Yer tutucuda gösterildiği gibi parametreleri süslü parantez içinde koyun. Parametreleri doğruladıktan sonra bildirim oluşturulurken kullanılacak karşılık gelen etiketleri girmeniz gerekecektir.)
İstek Yöntemi
WebHook isteği gönderilirken kullanılacak HTTP yöntemi. Bu durumda, GET, WebHook'un belirtilen URI'ye bir HTTP GET isteği ile tetikleneceği anlamına gelir.
Tetikleme Türü
WebHook'u tetikleyecek event veya eylem türü. Bu durumda mevcut seçenekler şunlardır:
Push Click: Bir kullanıcı push bildirime tıkladığında WebHook tetiklenecektir.
Message Log: Bir mesaj log eventi meydana geldiğinde WebHook tetiklenecektir.
Geofence: Bir geofence eventi algılandığında WebHook tetiklenecektir.
Event Seç
Eğer Event tetikleme türü olarak seçilirse, bu alan WebHook'u tetikleyecek belirli bir event'i (ör. belli bir push bildirimi veya geofence) seçmenize olanak tanır.
Örnek:
Kullanıcı etkileşimlerini belirli ürün kategorileriyle takip etmek isteyebilirsiniz. Bir kullanıcı ürün detay ekranını görüntülediğinde tetiklenecek bir WebHook ayarlayabilirsiniz. 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. Bu şekilde WebHook'u alan harici sistem farklı ürün kategorilerine yönelik kullanıcı ilgi alanlarını analiz edebilir.
WebHook Header'ları
Bunlar WebHook isteğine dahil edilebilecek HTTP header'larıdır. Harici uygulamanın işlemesi için ek bilgi veya kimlik doğrulama verisi taşıyabilirler.
Context Parameter: "Context Parameter" seçeneğini bir header için kullandığınızda, header değeri WebHook'u tetikleyen belirli event'in bağlamından alınır. Bağlam, bir kullanıcının profile attribute'ü, device attribute'ü veya event'e özgü diğer ilgili verilerle ilişkili olabilir. Bu, event'e dayalı dinamik bilgileri geçirmenizi sağlar.
Sabit Değer: "Sabit Değer" seçeneğini bir header için kullandığınızda, her WebHook isteğinde gönderilecek statik bir değer sağlarsınız. Bu, hangi event'in WebHook'u tetiklediğine bakılmaksızın 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 profile attribute'ünden, cihazın device attribute'ünden veya sabit bir değerden alınabilir.
Değer: Header parametresinin gerçek değeri.
Önemli Not:
Bazı durumlarda, WebHook isteklerini kimlik doğrulamanız gerekecektir ve istek header'larına bir API key veya authentication token eklemeniz gerekir. Bu senaryoda, API anahtarını veya token'ı header'da statik bir değer olarak sağlamak için "Sabit Değer" seçeneğini kullanabilirsiniz. Bu, hangi event'in WebHook'u tetiklediğine bakılmaksızın tüm WebHook isteklerinin gerekli kimlik doğrulamayı taşımasını sağlar.
WebHook Parametreleri
Bunlar WebHook isteğine dahil edilebilecek ek parametrelerdir. Header'lar gibi, tetikleyen event ile ilgili belirli verileri taşıyabilirler.
Anahtar: Parametrenin adı.
Değer Kaynağı: Parametrenin değerinin nasıl belirleneceğini belirtir. Değer, kullanıcının profile attribute'ünden, cihazın device attribute'ünden 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} gönderim yapıldığında 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ışları hakkında daha derin içgörüler elde etmenizi sağlar.
Last updated
Was this helpful?