WebHooks
Settings > WebHooks > Create New WebHook
WebHooks Netmera ile daha geniş dijital ekosistem arasında köprünüz olarak ortaya çıkar. Netmera hub'ınız ile harici uygulamalar arasında gerçek zamanlı olarak içgörüler, tetikleyiciler ve aksiyonlar taşıyan sanal bir kurye gibi düşünün.
Bu nedenle, bir mekanizmadır ki Netmera'dan bir harici web uygulamasına veya servisine bilgiyi gerçek zamanlı göndermenizi sağlar. Netmera uygulamanızı diğer sistemlerle entegre etmenin bir yoludur ve Netmera'daki belirli event'ler veya veri değişikliklerine dayalı olarak harici uygulamanızda aksiyon tetiklemenize olanak tanır.
İpucu:
Örneğin, Netmera'dan gönderilen push bildirimlerle kullanıcı etkileşimlerini izlemek ve analiz etmek istediğinizi varsayalım. Bir WebHook oluşturabilir ve bir kullanıcı bir push bildirimine tıkladığında tetiklenmesini sağlayabilirsiniz (Push Click event). Bu WebHook ardından tıklama event'iyle ilgili verileri daha ileri analiz ve raporlama için harici bir analiz sistemine gönderebilir.
Create New WebHook
WebHook Name
Netmera Control Panel ve raporlarda WebHook'u tanımlamak için kullanıcı tanımlı bir ad. Bu ad organizasyon amaçlıdır ve WebHook'un işleyişini etkilemez.
WebHook URI
Netmera'nın WebHook verisini göndereceği URL (Uniform Resource Identifier). Bu URL, WebHook verisini alacak harici web uygulaması veya servisin endpoint'ini 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ılan karşılık gelen etiketleri girmeniz gerekecektir.)
Request Method
WebHook isteği gönderilirken kullanılacak HTTP yöntemi. Bu durumda, GET, belirtilen URI'ye HTTP GET isteği ile WebHook'un tetikleneceği anlamına gelir.
Trigger Type
WebHook'u tetikleyecek event veya aksiyon türü. Bu durumda kullanılabilir seçenekler şunlardır:
Push Click: Bir kullanıcı bir push bildirime tıkladığında WebHook tetiklenir.
Message Log: Bir message log event'i oluştuğunda WebHook tetiklenir.
Geofence: Bir geofence event'i algılandığında WebHook tetiklenir.
Select Event
Eğer Event tetikleme türü olarak seçilirse, bu alan WebHook'u tetikleyecek belirli bir event'i (ör. belirli bir push bildirim veya geofence) seçmenize olanak tanır.
Örnek:
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 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 dahil edebilirsiniz. Böylece WebHook'u alan harici sistem, kullanıcıların farklı ürün kategorilerindeki ilgi alanlarını analiz edebilir.
WebHook Headers
Bunlar WebHook isteğine dahil edilebilecek HTTP header'larıdır. Harici uygulamanın işleyebilmesi için ek bilgi veya kimlik doğrulama verileri taşıyabilirler.
Context Parameter: Bir header için "Context Parameter" seçeneğini kullanırken, header değeri WebHook'u tetikleyen belirli event'in bağlamından alınır. Bağlam, bir kullanıcının profile attribute'u, cihaz attribute'u veya event'e özgü diğer ilgili verilerle ilişkili olabilir. Bu, event'e dayalı dinamik bilgi geçirmenize olanak tanır.
Fixed Value: Bir header için "Fixed Value" seçeneğini kullanırken, her WebHook isteğinde header değeri olarak gönderilecek statik bir değer sağlarsınız. Bu, WebHook'u tetikleyen belirli 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.
Key: Header parametresinin adı.
Value Source: Header parametresinin değerinin nasıl belirleneceğini belirtir. Değer, kullanıcının profile attribute'undan, cihaz attribute'undan veya sabit bir değerden alınabilir.
Value: Header parametresinin gerçek değeri.
Önemli Not:
Bazı durumlarda, WebHook isteklerini authenticate etmeniz gerekebilir; bunun için istek header'larına bir API key or authentication token eklemeniz gerekir. Bu senaryoda, header'da API anahtarını veya token'ı statik bir değer olarak sağlamak için "Fixed Value" seçeneğini kullanabilirsiniz. Bu, hangi event'in tetiklediğine bakılmaksızın tüm WebHook isteklerinin gerekli kimlik doğrulamayı taşımasını sağlar.
WebHook Parameters
Bunlar WebHook isteğine dahil edilebilecek ek parametrelerdir. Header'lar gibi, tetikleyen event ile ilgili belirli verileri de taşıyabilirler.
Key: Parametrenin adı.
Value Source: Parametrenin değerinin nasıl belirleneceğini belirtir. Değer, kullanıcının profile attribute'undan, cihaz attribute'undan veya sabit bir değerden alınabilir.
Value: Parametrenin gerçek değeri.
Sample Request
Bir örnek istek, WebHook isteğinin nasıl yapılacağını gösteren bir cURL komutu olarak sağlanır. ${hook.url} bir yer tutucudur ve istek gönderildiğinde gerçek WebHook URI ile değiştirilecektir.
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?