Segmentify Entegrasyonu

Genel Bakış

Bu rehber, Hardal analitiğini Hardal’ın Custom API destination özelliğini kullanarak Segmentify ile nasıl entegre edeceğinizi açıklar. Bu platformları bağlayarak, Hardal aracılığıyla toplanan first-party verilerinizi ürün önerileri, arama optimizasyonu ve engagement kampanyaları için Segmentify’ın kişiselleştirme motorunda kullanabilirsiniz.

Ön Koşullar

Entegrasyonu kurmadan önce, şunlara sahip olduğunuzdan emin olun:

Websitenizde tracking kurulu aktif bir Hardal hesabı
API erişimi olan aktif bir Segmentify hesabı
Segmentify API Anahtarınız ve Data Center URL’niz
Her iki platform ve JSON hakkında temel bilgi

Uygun entegrasyon, her iki platforma da admin erişimi gerektirir. Başlamadan önce gerekli izinlere sahip olduğunuzdan emin olun.

Segmentify API Gereksinimlerini Anlama

Segmentify, kullanıcı davranışını izlemek ve içeriği kişiselleştirmek için çeşitli event tiplerini kabul eden RESTful bir API kullanır. Anlaşılması gereken temel kavramlar:

Segmentify Event Tipleri

Event Adı	Açıklama	Segmentify Event Tipi
Page View	Kullanıcı bir sayfa görüntülediğinde	PAGE_VIEW
Product View	Kullanıcı bir ürün görüntülediğinde	PRODUCT_VIEW
Basket Operations	Sepete ürün ekleme/çıkarma	BASKET_OPERATIONS
Checkout	Çeşitli ödeme adımları	CHECKOUT
User Operations	Kullanıcı giriş, kayıt vb.	USER_OPERATIONS
Custom Event	Herhangi bir özel kullanıcı eylemi	CUSTOM_EVENT

Kimlik Doğrulama Gereksinimleri

Segmentify, kimlik doğrulama için bir API anahtarı ve belirli başlıklar gerektirir:

API Key (sorgu parametresi olarak dahil edilir)
Content-Type: application/json
Accept: application/json
Origin: Domain’iniz

Hardal’da Custom API Destination Kurma

Marketing Destinations'a Erişin

Hardal dashboard’unuza giriş yapın
Connections’a gidin
“Add Destination” butonuna tıklayın
Şablon seçeneklerinden “Custom API”yi seçin

Temel Ayarları Yapılandırın

Temel destination ayarlarını yapılandırın:

{
  "endpoint_label": "Segmentify Integration",
  "endpoint_id": "segmentify-integration",
  "endpoint_url": "https://[YOUR-DATA-CENTER].segmentify.com/add/events/v1.json?apiKey=[YOUR-API-KEY]",
  "request_method": "POST",
  "content_type": "application/json"
}

[YOUR-DATA-CENTER] ve [YOUR-API-KEY] kısımlarını gerçek Segmentify veri merkezi URL’niz ve API anahtarınızla değiştirin. Bu değerleri Segmentify hesabınızın Settings > Integrations bölümünde bulabilirsiniz.

Gerekli Başlıkları Ekleyin

Segmentify tarafından gerekli olan başlıkları yapılandırın:

{
  "headers": {
    "Content-Type": "application/json",
    "Accept": "application/json",
    "Origin": "https://yourdomain.com"
  }
}

https://yourdomain.com kısmını gerçek website domain’iniz ile değiştirin.

Hardal Event’lerini Segmentify Formatına Eşleştirme

Entegrasyonun en önemli kısmı, Hardal event’lerini beklenen Segmentify formatına doğru şekilde eşleştirmektir. Segmentify, istek gövdesinde bir event’ler dizisi bekler.

Yapılandırmanızı temiz ve düzenli tutmak için Segmentify’da izlemek istediğiniz her event tipi için ayrı bir API destination oluşturun.

Sayfa Görünüm Event’lerini Eşleştirme

Event Eşleştirmesi Oluşturun

Sayfa görünüm event’leri için istek formatını yapılandırın:

{
  "request_format": [
    {
      "name": "PAGE_VIEW",
      "userId": "##user_id##",
      "sessionId": "##session_id##",
      "device": "##device_type##",
      "pageUrl": "##page.url##",
      "referrer": "##page.referrer##",
      "category": "##properties.page_category##",
      "subCategory": "##properties.page_subcategory##"
    }
  ]
}

Bu, Hardal’ın değişkenlerini (içinde ##variable## ile işaretlenen) Segmentify’ın beklediği formata eşleştirir.

Koşul Oluşturun

Bu eşleştirmeyi yalnızca sayfa görünüm event’leri için tetiklemek üzere bir koşul ekleyin:

“Conditions” bölümünde, “Add Condition”a tıklayın
“Event Name” equals “page_view” olarak ayarlayın

Hardal uygulamanızın sayfa görünüm event’leriyle birlikte uygun sayfa kategori değerleri gönderdiğinden emin olun. Yaygın değerler arasında “Home Page”, “Product Page”, “Category Page” vb. bulunur.

Ürün Görünüm Event’lerini Eşleştirme

Ürün görünümleri, Segmentify’ın öneri motoru için çok önemlidir.

Event Eşleştirmesi Oluşturun

Ürün görünüm event’leri için istek formatını yapılandırın:

{
  "request_format": [
    {
      "name": "PRODUCT_VIEW",
      "userId": "##user_id##",
      "sessionId": "##session_id##",
      "device": "##device_type##",
      "productId": "##properties.product_id##",
      "title": "##properties.product_name##",
      "url": "##page.url##",
      "image": "##properties.product_image##",
      "category": "##properties.product_category##",
      "brand": "##properties.product_brand##",
      "price": ##properties.product_price##,
      "inStock": "##properties.product_in_stock##"
    }
  ]
}

Koşul Oluşturun

“Event Name” equals “product_view” olan bir koşul ekleyin.

Sepete Ekleme Event’lerini Eşleştirme

Sepete ürün ekleme gibi sepet işlemleri için:

Event Eşleştirmesi Oluşturun

{
  "request_format": [
    {
      "name": "BASKET_OPERATIONS",
      "userId": "##user_id##",
      "sessionId": "##session_id##",
      "device": "##device_type##",
      "step": "add",
      "productId": "##properties.product_id##",
      "price": ##properties.product_price##,
      "quantity": ##properties.quantity##
    }
  ]
}

Koşul Oluşturun

“Event Name” equals “add_to_cart” olan bir koşul ekleyin.

Sepetten Çıkarma Event’lerini Eşleştirme

Sepetten ürün çıkarma gibi sepet işlemleri için:

Event Eşleştirmesi Oluşturun

{
  "request_format": [
    {
      "name": "BASKET_OPERATIONS",
      "userId": "##user_id##",
      "sessionId": "##session_id##",
      "device": "##device_type##",
      "step": "remove",
      "productId": "##properties.product_id##",
      "quantity": ##properties.quantity##
    }
  ]
}

Koşul Oluşturun

“Event Name” equals “remove_from_cart” olan bir koşul ekleyin.

Ödeme Event’lerini Eşleştirme

Segmentify’daki ödeme event’leri, dönüşüm hunisini birden çok adımla takip eder.

Sepet Görüntüleme Ödeme Adımı

{
  "request_format": [
    {
      "name": "CHECKOUT",
      "userId": "##user_id##",
      "sessionId": "##session_id##",
      "device": "##device_type##",
      "step": "view-basket",
      "totalPrice": ##properties.total_price##,
      "currency": "##properties.currency##",
      "cartUrl": "##page.url##",
      "productList": ##properties.product_list##
    }
  ]
}

product_list şu formatta bir ürünler dizisi olmalıdır:

[
  {
    "productId": "PRODUCT_ID",
    "price": 349.99,
    "currency": "EUR",
    "quantity": 2
  }
]

Müşteri Bilgileri Ödeme Adımı

{
  "request_format": [
    {
      "name": "CHECKOUT",
      "userId": "##user_id##",
      "sessionId": "##session_id##",
      "device": "##device_type##",
      "step": "customer-info",
      "totalPrice": ##properties.total_price##,
      "currency": "##properties.currency##",
      "cartUrl": "##page.url##",
      "productList": ##properties.product_list##
    }
  ]
}

Ödeme Bilgileri Adımı

{
  "request_format": [
    {
      "name": "CHECKOUT",
      "userId": "##user_id##",
      "sessionId": "##session_id##",
      "device": "##device_type##",
      "step": "payment-info",
      "totalPrice": ##properties.total_price##,
      "currency": "##properties.currency##",
      "cartUrl": "##page.url##",
      "productList": ##properties.product_list##
    }
  ]
}

Satın Alma Tamamlama Adımı

{
  "request_format": [
    {
      "name": "CHECKOUT",
      "userId": "##user_id##",
      "sessionId": "##session_id##",
      "device": "##device_type##",
      "step": "purchase",
      "totalPrice": ##properties.total_price##,
      "orderNo": "##properties.order_id##",
      "currency": "##properties.currency##",
      "productList": ##properties.product_list##
    }
  ]
}

orderNo parametresi satın alma event’leri için zorunludur ve çift tracking’i önlemek için her sipariş için benzersiz olmalıdır.

Kullanıcı İşlemlerini Eşleştirme

Kullanıcı işlemleri, Segmentify’ın kullanıcı kimliğine dayalı deneyimleri kişiselleştirmesine yardımcı olur.

Kullanıcı Kaydı

{
  "request_format": [
    {
      "name": "USER_OPERATIONS",
      "userId": "##user_id##",
      "sessionId": "##session_id##",
      "device": "##device_type##",
      "step": "signup",
      "username": "##properties.username##",
      "fullName": "##properties.full_name##",
      "email": "##properties.email##",
      "phone": "##properties.phone##",
      "gender": "##properties.gender##"
    }
  ]
}

Cinsiyet için, Segmentify erkek için ‘M’, kadın için ‘F’ veya tanımsız için ‘U’ bekler.

Kullanıcı Girişi

{
  "request_format": [
    {
      "name": "USER_OPERATIONS",
      "userId": "##user_id##",
      "sessionId": "##session_id##",
      "device": "##device_type##",
      "step": "signin",
      "username": "##properties.username##"
    }
  ]
}

Kullanıcı Çıkışı

{
  "request_format": [
    {
      "name": "USER_OPERATIONS",
      "userId": "##user_id##",
      "sessionId": "##session_id##",
      "device": "##device_type##",
      "step": "signout",
      "username": "##properties.username##"
    }
  ]
}

Kullanıcı Güncelleme

{
  "request_format": [
    {
      "name": "USER_OPERATIONS",
      "userId": "##user_id##",
      "sessionId": "##session_id##",
      "device": "##device_type##",
      "step": "update",
      "username": "##properties.username##",
      "fullName": "##properties.full_name##",
      "email": "##properties.email##",
      "phone": "##properties.phone##",
      "gender": "##properties.gender##",
      "location": "##properties.location##",
      "segments": ##properties.segments##
    }
  ]
}

segments parametresi, belirli müşteri gruplarını hedeflemek için kullanışlı olan, kullanıcı segmentlerini temsil eden string’ler dizisi olmalıdır.

Entegrasyonu Test Etme

Yapılandırmayı Doğrulayın

Entegrasyonunuzu etkinleştirmeden önce, yapılandırmanızı doğrulayın:

Hardal’ın bazı event’ler göndermesi için bir süre bekleyin
Segmentify’da alınan event’leri kontrol edin

Segmentify'da Event'leri İzleyin

Segmentify dashboard’unuza giriş yapın
“Real-time Events” bölümünü kontrol edin
Hardal’dan gelen event’lerin doğru şekilde alındığını doğrulayın

Tam Dönüşüm Akışını Test Edin

Sayfa görünümünden satın almaya kadar eksiksiz bir test gerçekleştirin:

Event’leri izlerken websitenizi gezin
Bir ürün görüntüleyin
Sepete ekleyin
Test satın alması tamamlayın
Her adımın Segmentify’da izlendiğini doğrulayın

Entegrasyonu Etkinleştirin

Test başarılı olduğunda:

Hardal Custom API destination ayarlarınıza dönün
“Save Changes” butonuna tıklayın
Stabiliteyi sağlamak için event akışını birkaç gün izleyin

Sorun Giderme

Event'ler Alınmıyor

Geçersiz Event Formatı

Eksik Kullanıcı veya Oturum ID'leri

En İyi Uygulamalar

Veri Tutarlılığı

Hardal ve Segmentify arasında tutarlı veri formatları koruyun:

Tüm platformlar arasında aynı ürün ID’lerini kullanın
Sistemler arasında kategori hiyerarşilerinin eşleştiğinden emin olun
Kullanıcı özellikleri için tutarlı adlandırma kuralları kullanın

Performans Optimizasyonu

API çağrılarını en aza indirmek için ilgili event’leri gruplandırın
Uygun hata yönetimi uygulayın
Yüksek hacimli event’ler için toplu işleme kullanmayı düşünün

Güvenlik Hususları

Segmentify API anahtarınızı asla client-side kodunda açığa çıkarmayın. Hardal server-side entegrasyonu anahtarınızın güvende kalmasını sağlar.

API anahtarlarınızı düzenli olarak değiştirin
Mümkünse IP kısıtlamaları uygulayın
Gizlilik endişelerini en aza indirmek için yalnızca gerekli verileri gönderin

Başlangıç

Kurulum

Server-side Hosts

Entegrasyonlar

Veri Analizi

Veri İşleme

Sık Sorulan Sorular

Güncelleme Notları

Segmentify Entegrasyonu

Genel Bakış

Ön Koşullar

Segmentify API Gereksinimlerini Anlama

Segmentify Event Tipleri

Kimlik Doğrulama Gereksinimleri

Hardal’da Custom API Destination Kurma

Hardal Event’lerini Segmentify Formatına Eşleştirme

Sayfa Görünüm Event’lerini Eşleştirme

Ürün Görünüm Event’lerini Eşleştirme

Sepete Ekleme Event’lerini Eşleştirme

Sepetten Çıkarma Event’lerini Eşleştirme

Ödeme Event’lerini Eşleştirme

Kullanıcı İşlemlerini Eşleştirme

Entegrasyonu Test Etme

Sorun Giderme

En İyi Uygulamalar

Veri Tutarlılığı

Performans Optimizasyonu

Güvenlik Hususları

Kaynaklar

Başlangıç

Kurulum

Server-side Hosts

Entegrasyonlar

Veri Analizi

Veri İşleme

Sık Sorulan Sorular

Güncelleme Notları

​Genel Bakış

​Ön Koşullar

​Segmentify API Gereksinimlerini Anlama

​Segmentify Event Tipleri

​Kimlik Doğrulama Gereksinimleri

​Hardal’da Custom API Destination Kurma

​Hardal Event’lerini Segmentify Formatına Eşleştirme

​Sayfa Görünüm Event’lerini Eşleştirme

​Ürün Görünüm Event’lerini Eşleştirme

​Sepete Ekleme Event’lerini Eşleştirme

​Sepetten Çıkarma Event’lerini Eşleştirme

​Ödeme Event’lerini Eşleştirme

​Kullanıcı İşlemlerini Eşleştirme

​Entegrasyonu Test Etme

​Sorun Giderme

​En İyi Uygulamalar

​Veri Tutarlılığı

​Performans Optimizasyonu

​Güvenlik Hususları

​Kaynaklar

Genel Bakış

Ön Koşullar

Segmentify API Gereksinimlerini Anlama

Segmentify Event Tipleri

Kimlik Doğrulama Gereksinimleri

Hardal’da Custom API Destination Kurma

Hardal Event’lerini Segmentify Formatına Eşleştirme

Sayfa Görünüm Event’lerini Eşleştirme

Ürün Görünüm Event’lerini Eşleştirme

Sepete Ekleme Event’lerini Eşleştirme

Sepetten Çıkarma Event’lerini Eşleştirme

Ödeme Event’lerini Eşleştirme

Kullanıcı İşlemlerini Eşleştirme

Entegrasyonu Test Etme

Sorun Giderme

En İyi Uygulamalar

Veri Tutarlılığı

Performans Optimizasyonu

Güvenlik Hususları

Kaynaklar