Termékszintű jutalék-felülírások beállítása

Amikor az API-n keresztül nyomkövetsz egy rendelést, minden kéréssel elküldhetsz egy product objektumot. A Yaplet ezt metaadatként tárolja a jutalékrekordon, riportolás céljából; a tényleges felülíró összeg a kérésben átadott commission érték, amelyet a webáruházi rendszered számol ki. Hasznos, ha magas haszonkulcsú termékeken vagy olyan új SKU-kon szeretnéd jobban jutalmazni a partnereket, amelyeket kifejezetten promózni szeretnél.

Hogyan működnek a termékfelülírások?

A jutalékszámítás elsőbbségi sorrendben történik:

1. Partneri felülírás (legmagasabb prioritás) — ha a partnernél be van kapcsolva az Ignore Product Rate beállítás, a partner saját kulcsát mindig alkalmazza a rendszer, függetlenül az átadott terméktől.
2. Egyéni jutalék az API-kérésben — ha az API-hívás tartalmaz egy commission értéket, pontosan az az összeg kerül felhasználásra, kivéve, ha az 1. szabály már érvényesült.
3. Partneri kulcs — ha a partnernek van beállított kulcsa, és az Ignore Product Rate ki van kapcsolva, a partneri kulcs érvényes.
4. Nincs jutalék — ha a fentiek egyike sem teljesül, a jutalék 0.

Termékadatok átadása a nyomkövető API-hívásban

Szerepeltesd a product mezőt és egy explicit commission értéket a POST-kérésedben:

POST https://yaplet.com/api/affiliates/track/{affiliate_code}

{
  "order_id": "order_789",
  "total_amount": 249.00,
  "customer": { "email": "[email protected]" },
  "product": {
    "id": "prod_premium",
    "name": "Premium Plan",
    "category": "subscription"
  },
  "commission": 37.35
}

Ebben a példában explicit módon megadjuk a commission értékét (37.35) — hasznos, ha a webáruházi rendszered már kiszámította az adott SKU helyes jutalékát.

A partner kontra termék prioritásának szabályozása

Partnerenként bekapcsolható az Ignore Product Rate kapcsoló a partner beállításainál. Ha ez be van kapcsolva, a partner saját kulcsa mindig elsőbbséget élvez — még akkor is, ha a product objektumot vagy a commission értéket megadod az API-ban. Ezt akkor érdemes használni, ha egy partnernek tárgyalt fix megállapodása van, amelyet termékszabályok sem írhatnak felül.

Mi a következő lépés?

Lásd a teljes kérési referenciát és kódpéldákat JavaScript, PHP és Python nyelven: A partnernyomkövető API használata.