Dönüşümleri ve satışları ilişkilendirme

Dönüşüm, LinkHarbor’ın sayfandaki bir tıklamaya atfedebildiği bir satış veya destekçi ödemesidir. Böylece yalnızca bir bağlantının kaç kez tıklandığını değil, bundan ne çıktığını da görürsün. Bu makale kendi mağazası olan içerik üreticileri ve mağazayı bağlayan geliştiriciler içindir. Dönüşümleri analiz etmek ve callback gizli anahtarı oluşturmak Creator Pro’dan itibaren mümkündür.

#Dönüşümler nereden gelir

• Mağazanın veya sunucunun bir satış callback’iyle bildirdiği satışlar
• Stripe üzerinden destekçi ödemeleri; bir iade dönüşümü yeniden kaldırır, bkz. Stripe ile destekçi ödemeleri

Her dönüşüm ait olduğu tıklamanın verilerini devralır: sayfa, bağlantı, ülke, cihaz, yönlendiren ve UTM parametreleri. Bu yüzden istatistiklerde tam olarak tıklamanın geldiği yerde görünür.

#İlişkilendirme nasıl çalışır

1. Bir ziyaretçi sayfandaki bir bağlantıya tıklar
2. LinkHarbor tıklamayı sayar ve yönlendirirken hedef URL’ye benzersiz bir tıklama kimliğiyle lt_click_id parametresini ekler
3. Hedef sayfan (örneğin mağaza) lt_click_id’yi adresten okur ve satın almaya kadar saklar
4. Satın almadan sonra sunucun bu tıklama kimliğiyle LinkHarbor’a bir satış callback’i gönderir
5. Dönüşüm panelde ve sayfanın istatistiklerinde görünür

Tıklama kimliği yalnızca http:// veya https:// ile başlayan hedeflere eklenir. mailto: veya tel: bağlantıları kimlik almaz, çünkü parametre oradaki konuyu veya telefon numarasını bozar. Botlardan gelen tıklamalar da tıklama kimliği almaz.

#Callback gizli anahtarı oluştur

Bir satış callback’i kendini bir callback gizli anahtarıyla tanıtmalıdır. Sahipler ve yöneticiler gizli anahtarları Creator Pro’dan itibaren menünün hesap bölümündeki “Callback ve API” altında yönetir.

1. “Callback ve API”yi aç
2. “Callback gizli anahtarları” kartında “+ Yeni gizli anahtar oluştur”a tıkla
3. İstersen bir ad gir, örneğin “Mağaza callback’i”
4. “Gizli anahtar oluştur”a tıkla
5. Gizli anahtarı hemen kopyala: yalnızca bir kez gösterilir

“Düzenle”

Adı ve durumu (Aktif veya Pasif) değiştir. Pasif bir gizli anahtar reddedilir.

“↺ Yenile”

Yeni bir gizli anahtar oluşturur. Eskisi hemen çalışmayı bırakır – bu yüzden yenisini hemen mağazana gir.

“Sil”

Bir onay sorusundan sonra gizli anahtarı kaldırır.

“Son callback:”

Gizli anahtarın en son ne zaman kullanıldığını gösterir, aksi halde “Henüz kullanılmadı”.

Çalışma alanı başına en fazla 5 callback gizli anahtarı oluşturabilirsin.

#Satış callback’ini gönder

Sunucun LinkHarbor API’sine bir POST isteği gönderir. Gizli anahtar X-Callback-Secret başlığına girer.

curl -X POST https://dock.at-harbor.com/v1/callbacks/sale \
  -H "Content-Type: application/json" \
  -H "X-Callback-Secret: YOUR_CALLBACK_SECRET" \
  -d '{
    "click_id": "3f2b8c1e-5d4a-4b7e-9a10-2c6d8e0f1a23",
    "order_id": "B-10042",
    "amount": "49.90",
    "currency": "EUR"
  }'

click_id

Zorunlu. lt_click_id’den gelen tıklama kimliği (10–36 karakter).

order_id

Zorunlu. Sipariş numaran (1–128 karakter). Sipariş numarası başına yalnızca bir dönüşüm sayılır, bu yüzden tekrarlanan bir callback ikinci bir dönüşüm oluşturmaz.

amount

Zorunlu. Ondalık sayı olarak tutar.

currency

Zorunlu. 3 harfli bir para birimi kodu, örneğin EUR.

occurred_at, meta

İsteğe bağlı. Satın alma zamanı ve ek bilgilerle en fazla 50 özel anahtar (her biri 1–64 karakter). Bir değer en fazla 500 karakterlik metin, sayı, true/false veya null olabilir; API iç içe nesneleri reddeder.

Yanıtlar

Geliştiriciler için tüm alanlar ve hata kodları Satışları ve özel verileri gönderme bölümünde.

#Dönüşümleri analiz etme

• Panel: “Dönüşüm” ve “DO” kutucukları ile UTM kaynağı ve ortamına göre “Dönüşüm” kartı
• Sayfa istatistikleri: “Toplam DO”, “Tekil DO” ve “Kırılım” içeren “Dönüşüm” kartı
• Toplam DO = dönüşümlerin tıklamalara bölümü; Tekil DO = dönüşümlerin tekil tıklamalara bölümü