Webhook'lar

Ayarlar > Uygulama Yapılandırması > WebHook'lar > Yeni WebHook Oluştur

WebHook'lar Netmera ile daha geniş dijital dünya arasında köprü görevi görür. Netmera merkezinizi ve harici uygulamaları gerçek zamanlı olarak birbirine bağlayan, içgörüleri, tetikleyicileri ve işlemleri taşıyan sanal bir haberciyi hayal edin.

Bu nedenle, bir mekanizmadır Netmera’dan harici bir web uygulamasına veya hizmetine gerçek zamanlı olarak bilgi göndermenizi sağlar. Netmera uygulamanızı diğer sistemlerle entegre etmenin bir yoludur ve Netmera’daki belirli olaylara veya veri değişikliklerine bağlı olarak harici uygulamanızda işlemleri tetiklemenizi sağlar.

İpucu:

Örneğin, Netmera’dan gönderilen push bildirimleriyle kullanıcı etkileşimlerini izlemek ve analiz etmek istediğinizi varsayalım. Bir WebHook kullanıcı bir push bildirimine tıkladığında (Push Tıklaması olayı). Bu WebHook daha sonra tıklama olayıyla ilgili verileri daha ileri analiz ve raporlama için harici bir analiz sistemine gönderebilir.

Yeni WebHook Oluştur

WebHook Adı

Netmera Kontrol Paneli ve raporlarında WebHook’u tanımlamak için kullanıcı tarafından belirlenen bir ad. Bu ad organizasyon amacıyla kullanılır ve WebHook’un çalışmasını etkilemez.

WebHook URI’si

Netmera’nın WebHook verilerini göndereceği URL (Uniform Resource Identifier). Bu URL, WebHook verilerini alacak harici web uygulamasının veya hizmetin uç noktasını göstermelidir. (Yer tutucuda gösterildiği gibi parametreleri süslü parantezler içine yerleştirin. Parametreleri doğruladıktan sonra, bildirim oluştururken kullanılan karşılık gelen etiketleri girmeniz gerekecektir.)

İstek Yöntemi

WebHook isteği gönderilirken kullanılacak HTTP yöntemi. Bu durumda, bu GET; yani WebHook, belirtilen URI’ye bir HTTP GET isteğiyle tetiklenecektir.

Tetikleyici Türü

WebHook’u tetikleyecek olay veya eylem türü. Bu durumda kullanılabilir seçenekler şunlardır:

• Push Tıklaması: Kullanıcı bir push bildirimine tıkladığında WebHook tetiklenecektir.

• Mesaj Kaydı: Bir mesaj kaydı olayı gerçekleştiğinde WebHook tetiklenecektir.

• Geofence: Bir geofence olayı algılandığında WebHook tetiklenecektir.

Olay Seç

Eğer Olay tetikleyici türü olarak seçildiğinde, bu alan WebHook’u tetikleyecek belirli bir olayı (ör. belirli bir push bildirimi veya geofence) seçmenize olanak tanır.

WebHook'lar

Örnek:

Belirli ürün kategorileriyle kullanıcı etkileşimlerini izlemek isteyebilirsiniz. Bir kullanıcının ürün detay ekranını görüntülediğinde tetiklenecek şekilde bir WebHook kurabilirsiniz. Ardından, görüntülenen ürünün bağlamından alınan ürün kategorisini bir başlık değeri olarak eklemek için "Bağlam Parametresi" seçeneğini kullanabilirsiniz. Böylece, WebHook’u alan harici sistem farklı ürün kategorilerindeki kullanıcı ilgilerini analiz edebilir.

WebHook Başlıkları

Bunlar WebHook isteğine eklenebilecek HTTP başlıklarıdır. Harici uygulamanın işlemesi için ek bilgi veya kimlik doğrulama verileri taşıyabilirler.

1. Bağlam Parametresi: Bir başlık için "Bağlam Parametresi" seçeneğini kullanırken, başlık değeri WebHook’u tetikleyen belirli olayın bağlamından alınır. Bu bağlam kullanıcının profil özniteliği, cihaz özniteliği veya olaya özgü diğer ilgili verilerle ilişkili olabilir. Bu, olaya göre dinamik bilgi aktarmanıza olanak tanır.

2. Sabit Değer: Bir başlık için "Sabit Değer" seçeneğini kullanırken, sağladığınız statik bir değer her WebHook isteğinde başlık değeri olarak gönderilir. Bu, WebHook’u tetikleyen belirli olaydan bağımsız olarak aynı değerin kullanılacağı anlamına gelir. Başlık değeri tüm WebHook istekleri için sabit olduğunda kullanışlıdır.

Anahtar: Başlık parametresinin adı.

Değer Kaynağı: Başlık parametresinin değerinin nasıl belirleneceğini belirtir. Kullanıcının profil özniteliğinden, cihaz özniteliğinden veya sabit bir değerden alınabilir.

Değer: Başlık parametresinin gerçek değeri.

Önemli Not:

Bazı durumlarda, WebHook isteklerini kimlik doğrulaması yapmak için bir API anahtarı veya kimlik doğrulama belirteci ekleyerek "Sabit Değer" seçeneğini kullanarak API anahtarını veya belirteci başlıkta statik bir değer olarak sağlayabilirsiniz. Bu, bunları tetikleyen belirli olaylardan bağımsız olarak tüm WebHook isteklerinin gerekli kimlik doğrulamayı taşımasını sağlar.

WebHook Başlıkları

WebHook Parametreleri

Bunlar WebHook isteğine eklenebilecek ek parametrelerdir. Başlıklar gibi, WebHook’u tetikleyen olayla ilgili belirli verileri de taşıyabilirler.

WebHook Parametreleri

Anahtar: Parametrenin adı.

Değer Kaynağı: Parametrenin değerinin nasıl belirleneceğini belirtir. Kullanıcının profil özniteliğinden, cihaz özniteliğinden veya sabit bir değerden alınabilir.

Değer: Parametrenin gerçek değeri.

Örnek İstek

WebHook isteğinin nasıl yapılacağını gösteren bir cURL komutu olarak örnek bir istek sunulur. Bu ${hook.url} istek gönderildiğinde gerçek WebHook URI’si ile değiştirilecek bir yer tutucudur.

Örnek

Genel olarak, Netmera’da bir WebHook oluşturmak, uygulamanızı diğer hizmetlerle entegre ederek işlevselliğini genişletmenizi, iş akışlarını otomatikleştirmenizi ve kullanıcı davranışı hakkında daha derin içgörüler elde etmenizi sağlar.