Satış Ortaklığı Kancaları

1.7k görüntülenme Markdown

Katılım, komisyon, yönlendirme tıklaması ve ödeme talebinin dört kancası.

Genel Bakış

Satış ortaklığının dört anı burada: bir müşteri programa katılır, bağlantısına tıklanır, bir satıştan komisyon doğar ve kazancının ödenmesini ister.

Bir ayrım baştan bilinmeli: ortaklık kaydının kimliği ile müşterinin kimliği ayrı numaralardır ve kancalar ikisini de ayrı taşır.

Referans

Ortaklık katılımını izleme

actionuser.affiliate_activated
ClientAffiliate katılım anı

Bir müşteri satış ortaklığı programına katıldıktan sonra çalışır.

Parametreler 2
$user_idintOrtak olan hesabın kimliği.
$aff_idintOluşan ortaklık kaydının kimliği. Bu, müşteri kimliğinden farklı bir numaradır; kardeş kancalar ikisini ayrı ayrı taşır.
Dönüş 1
voidDönüş yoksayılır.
Dinleyici
Hook::add('action:user.affiliate_activated', 10, function ($user_id, $aff_id) {
    // Iki kimlik farkli: ortaklik kaydi ile musteri ayni numara degil.
    Acme::openPartnerDashboard($user_id, $aff_id);
});

Komisyon oluşmasını izleme

actionuser.affiliate_commission_created
ClientAffiliate satış ve yenileme

Bir ortağa komisyon yazıldıktan sonra çalışır. Hem ilk satış hem yenileme bu kancaya düşer.

Parametreler 4
$affiliate_idintKomisyonu alan ortağın kaydı.
$servicearrayKomisyona konu hizmet: tutarı, para birimi ve sahibi.
$transaction_typestringsale ilk satış, renewal yenileme. Yenilemede komisyon her dönem tekrar oluşur: tek seferlik bir ödül vereceksen bu ayrımı gözet.
$commissionfloatHesaplanan komisyon tutarı.
Dönüş 1
voidDönüş yoksayılır.
Dinleyici
Hook::add('action:user.affiliate_commission_created', 10,
    function ($affiliate_id, $service, $transaction_type, $commission) {
        // Yenilemede komisyon her donem tekrar olusur.
        if ($transaction_type === 'sale') Acme::rewardFirstSale($affiliate_id);
    });

Yönlendirme tıklamasını izleme

actionuser.affiliate_referral_clicked
ClientAffiliate her tıklamada

Bir ortağın bağlantısına tıklandığında çalışır. Her tıklamada çalışır: satış olmasa da, ziyaretçi giriş yapmasa da.

Parametreler 2
$ownerIdintOrtağın müşteri kimliği; kayıt anahtarı budur.
$contextarrayTıklama bağlamı: ortaklık kaydı, gelinen adres ve ziyaretçinin adresi. Gelinen adres boş olabilir; kişisel veri sayılabileceği için sakladığınız süreye dikkat edin.
Dönüş 1
voidDönüş yoksayılır.
Dinleyici
Hook::add('action:user.affiliate_referral_clicked', 10, function ($ownerId, $context) {
    // Her tiklamada calisir: agir is koymayin.
    Acme::countClick($ownerId);
});

Ödeme talebini izleme

actionuser.affiliate_withdrawal_requested
ClientAffiliate ödeme henüz yapılmadı

Ortak kazancının ödenmesini istediğinde çalışır. Ödeme yapılmamıştır: kayıt beklemede açılır.

Parametreler 6
$uidintTalep eden müşteri.
$affIdintOrtaklık kaydı; müşteri kimliği değildir.
$amountfloatTalep edilen tutar; veritabanına yazılanla birebir aynıdır.
$cidintOrtağın para birimi.
$gatewaystringSeçilen ödeme kanalı.
$widintOluşan talep kaydı; her zaman sıfırdan büyüktür.
Dönüş 1
voidDönüş yoksayılır.
Dinleyici
Hook::add('action:user.affiliate_withdrawal_requested', 10,
    function ($uid, $affId, $amount, $cid, $gateway, $wid) {
        // Odeme YAPILMADI: talep beklemede acildi.
        Acme::queuePayout($wid, $affId, $amount, $gateway);
    });

Tuzaklar

Ortaklık kaydı ile müşteri ayrı numaralardır

Ödeme talebi kancası hem müşteri kimliğini hem ortaklık kaydını taşır ve bunlar aynı sayı değildir. Ortaklık kaydını müşteri kimliği sanmak, kazancı yanlış hesaba yazar.

Yenilemede komisyon her dönem tekrar doğar

Komisyon kancası hem ilk satışta hem her yenilemede çalışır. Tek seferlik bir ödül veriyorsanız işlem türüne bakın; yoksa aynı müşteri için ödülü her ay yeniden verirsiniz.

Faydalı oldu mu?

Geri bildiriminiz için teşekkürler!

Hâlâ Yardıma mı İhtiyacınız Var?

Yukarıda bulamadığınız her şey için destek ekibimiz her zaman yanınızda.