Entegrasyona genel bakış

cli.gs yalnızca mağazanın bildirdiği satışlar için komisyon öder. Bu sayfada bir satışın yayıncı bağlantısından kaydedilen komisyona nasıl ulaştığını, API anahtarını nereden alacağını ve entegrasyonu hangi sırayla kuracağını görürsün. İşin çoğu senin sunucunda olur: açılış sayfasına birkaç satır ve sipariş oluştuğunda tek bir HTTP çağrısı.

Kısaca:

• Ziyaretçi, URL'de ?ref=... ile gelir. Mağazan bu ref kodunu siparişe kadar saklar.
• Sunucun siparişi API anahtarınla doğrulanmış olarak POST /api/v1/track/conversion adresine bildirir.
• Komisyonu yalnızca sunucu postback'i kaydeder. Takip pikseli bir yedektir.
• Her programın kendi API anahtarı vardır. Anahtar sunucuda kalır, asla tarayıcıda değil.
• Şu sırayla kur: ref kodunu yakala, dönüşümleri bildir, istekleri imzala, iadeleri bildir, test et.

Bir satışın yolculuğu

1. Bir ziyaretçi, yayıncının bağlantısına tıklar, örneğin https://cli.gs/@mara/demoshop.
2. cli.gs tıklamayı kaydeder. Ardından ziyaretçiyi hedef URL'ne yönlendirir ve bir referans kodu ekler: https://shop.example.com/?ref=01J9Z4K6V0QX8M2N3P5R7S9T1WABCD.
3. Mağazan URL'den ref değerini okur ve ödeme adımına kadar bir çerezde veya oturumda saklar.
4. Sipariş verildiğinde veya ödendiğinde sunucun ref kodunu, sipariş numaranı ve tutarı POST https://cli.gs/api/v1/track/conversion adresine gönderir. İstek API anahtarınla doğrulanır.
5. Biz kodu kontrol eder, komisyon kurallarını uygular ve dönüşümü kaydederiz. Dönüşüm buradan sonra program için belirlediğin onay süresinden ve bekleme süresinden geçer. Her iki kavram cli.gs nasıl çalışır sayfasında açıklanıyor.
6. Müşteri ürünü iade ederse sunucun bir iptal bildirir. Komisyon geri alınır.

Ref kodu, atfın kendisidir. Tıklamayı, dolayısıyla yayıncıyı ve programı tanımlar. Son tıklama kazanır. Kod 2. ve 4. adım arasında kaybolursa satış kimseye atfedilemez ve bunu sonradan kimse düzeltemez.

Bildirmenin iki yolu

Kurman gereken kanal sunucu postback'i. Reklam engelleyiciler onu durduramaz, tarayıcı depolama sınırları onu etkilemez ve sunucun isteği yeniden deneyebilir.

Takip pikseli yalnızca bir yedektir. Herkes onun URL'sini istediği tutarla yükleyebilir. Bu yüzden piksel dönüşümü, aynı sipariş için bir postback onaylayana veya sen elle onaylayana kadar bekletilir. Bkz. Takip pikseli.

API anahtarın

Sunucunun bir şey bildirebilmesi için önce anahtara ihtiyacı var. Her programın kendi anahtarı vardır.

1. Ortaklık programları sayfasını aç ve programı seç.
2. Entegrasyon düğmesine tıkla.
3. İlk bölüm olan API anahtarı altında Anahtar üret düğmesine tıkla. Düğme, programı incelemeye gönderdikten sonra çalışır.
4. Anahtarı doğrudan mağazanın yapılandırmasına veya gizli anahtar deposuna kopyala.

Ne alırsın

• Anahtar cligs_sk_ ile başlar ve yalnızca bir kez gösterilir. Biz sadece özetini (hash) saklarız, bu yüzden tekrar gösteremeyiz.
• İlk anahtarla birlikte imzalı istekler için bir İmza anahtarı da alırsın. O da yalnızca bu bir kez gösterilir.

Anahtar kaybolduysa veya sızmış olabilirse

Yeni anahtar üret düğmesine tıkla. Eski anahtar 24 saat daha çalışır; böylece yenisini dönüşüm kaybetmeden devreye alabilirsin. İmza anahtarı aynı kalır.

Bir anahtar yalnızca kendi programındaki tıklamalardan gelen ref kodlarını kabul eder. Başka bir programın kodu REF_PROGRAM_MISMATCH ile reddedilir.

Bu sırayla kur

Bu bölümün sayfalarını sırayla izle:

1. Açılış sayfalarında ref kodunu yakala ve siparişe kadar sakla.
2. Sipariş oluştuğunda sunucundan dönüşümleri bildir.
3. İsteklerini imzala, sonra İmzasız istekleri reddet seçeneğini aç.
4. İade edilen ürünler için ödeme yapmamak üzere iadeleri ve iptalleri bildir.
5. İsteğe bağlı olarak takip pikselini ve bir durum bildirimi ekle. Durum bildirimi, mağazana onayları ve retleri iletir.
6. Gerçek trafik gelmeden önce test: true ile her şeyi test et.

Entegrasyon sayfasının iki bölümü yol boyunca yardımcı olur. Parametreler tüm alanları listeler ve oradaki kod örnekleri programının değerlerini zaten içerir. Entegrasyon durumu, ref kodunun mağazanın yönlendirmelerinden sağ çıkıp çıkmadığını ve bildirimlerin reddedilip reddedilmediğini gösterir.

Sonraki adımlar

ref kodunu yakala ile başla. Çoğu entegrasyonun yanlış yaptığı adım budur ve bu olmadan başka hiçbir şey çalışmaz.