Popis integrácie pre Inzerentov

Obecný postup

Na našej platforme sú dve strany, kasína, stávkové kancelárie a lotérie (Inzerenti) a Affiliate partneri.

Začiatok spolupráce pre Inzerenta vyzerá z technického hľadiska takto:

  1. Klient nám pošle webové bannery s rôznou grafikou a rozmermi.
  2. Pre každého partnera vytvoríme jedinečnú kampaň, ktorá v systéme reprezentuje jeho kasíno, a túto kampaň ponúkneme našim partnerom na inzerciu na platforme.
  3. V rámci kampane nastavíme affiliate partnerom podmienky podľa zmluvy s inzerentom vrátane doby životnosti hráčov, odmeny CPA, progresívnej provízie atď.
  4. Každý banner dostane svoj vlastný jedinečný odkaz, ktorý bude obsahovať údaje o kampani a affiliate partnerovi. Príklad odkazu: https://go.affilmaster.com/scripts/cdvy4d2?a_aid={refid}&a_bid={bannerid}, tento odkaz potom vedie priamo k partnerovi. Napríklad: https://www.casino.com/cs/?a_aid=IDAffiliate&a_bid=IDbanneru&visitorId=VisitorID.
  5. Po kliknutí na banner dôjde k presmerovaniu do vášho kasína spolu s jedinečnou hodnotou „visitorId„, ktorá definuje vzťah používateľa k affiliate partnerovi a kampani cookie. Keď je táto hodnota uložená vo vašej databázy, odporúčame ju z výslednej adresy URL odstrániť (pomocou JS, …), aby sa zabránilo kopírovaniu jedinečnej hodnoty, keď hráč zdieľa adresu URL s iným hráčom.
  6. Hráč sa zaregistruje v kasíne a vykoná vklad. Prehrá sumu. (Tieto údaje od vás musíme získať pomocou volaní S2S zo systému).
  7. Pošlite nám vyššie uvedené údaje najmä pre aktuálneho hráča na náš koncový bod a my ich zadáme do systému k príslušnému partnerovi a kampani.

Na dosiahnutie vyššie uvedeného musí vaše kasíno odosielať určité informácie o transakciách a registrovaných hráčoch:

  • ID zákazníka (jedinečný identifikátor pridelený vaším systémom), ktorý bol v systéme sledovaný po úspešnej registrácii (customerID).
  • sumu alebo hodnotu sledovanej transakcie (TotalCost).
  • jedinečné 32-miestne „visitorId“, ktoré sa musí uložiť do databázy zo súboru cookie pri registrácii hráča.

Ak máme tieto informácie, odošleme údaje do nášho Postback endpointu. Volanie bude vyzerať približne takto:

https://go.affilmaster.com/scripts/sale.php?TotalCost={amount}&ActionCode={actionCode}&ProductID={productID}
&data1={customerID}&OrderID={orderID-123XYZ}&VisitorID={clickID}&Currency={CZK}&CampaignID={campaignID}&data5={MD5hash}

Platforma a support

Ako platformu používame PostAffiliatePro, ktorá má vlastnú Knowledge base. V prípade potreby si pozrite všeobecný postup integrácie v odkazoch nižšie alebo kontaktujte priamo AffilMaster ([email protected]).

Existuje niekoľko spôsobov pripojenia systému, ale vo všeobecnosti odporúčame volania S2S na náš endpoint pomocou metódy Postback, prípadne pomocou JSON.

Ak nie je možné použiť tieto riešenia, je možné zorganizovať videohovor s našimi partnerskými vývojármi.

Sledovaná data

Úplná integrácia sleduje niekoľko udalostí, ktoré sa odohrávajú vo vašom kasíne.

  1. Prekliky na webové stránky inzerenta (merané automaticky programom Post Affiliate Pro)
  2. Overená registrácia
  3. First time deposit (FTD)
  4. Vklad
  5. NGR relácia
  6. Objem stávok v relácii
  7. Bonus
  8. Výber

Overená registrácia

Na sledovanie overenej registrácie je potrebné uskutočniť volanie S2S, keď je registrácia hráča úspešne overená v súlade so slovenskou legislatívou.

https://go.affilmaster.com/scripts/sale.php?TotalCost=0&ActionCode=registration&ProductID=registration&Data1={customerID}&OrderID={orderID-123XYZ}&VisitorID={clickID}&CampaignID={campaignID}&Data5={MD5hash}
  • Pre TotalCost – definujte hodnotu „0“.
  • Pre ActionCode – definujte „registration“.
  • Pre ProductID – definujte „registration“.
  • Pre Data1 – zadajte ID zákazníka. (Ak spravujete viacero kasín, uistite sa, že táto hodnota je jedinečná pre všetkých vašich klientov)
  • Pre OrderID – vygenerujte alebo prepíšte jedinečné ID transakcie, ktoré je dostatočne zložité, aby nedošlo k duplicite.
  • Pre VisitorID – prepíšte 32-miestny hash, ktorý ste získali zo súboru cookie návštevníka, a majte ho uložený v DB pre aktuálneho hráča.
  • Pre CampaignID – zadajte ID kampane, ktoré ste dostali od našej podpory a ktoré je jedinečné pre každé kasíno.
  • Pre Data5 – vypíšte zašifrovanú hodnotu v tejto kombinácii vrátane čiarok bez úvodzoviek „TotalCost,OrderID,SecretKey“ aktuálnej transakcie pomocou MD5 Hash. Hodnotu „SecretKey“ dostanete na požiadanie od našej podpory. (Výslednú hodnotu pošlite v Data5 len vo formáte s malými písmenami).

First Time Deposit

Ak chcete sledovať FTD, musíte pri potvrdení prvého úspešného vkladu hráča uskutočniť hovor S2S. Túto transakciu je potrebné odoslať len v prípade prvého úspešného vkladu hráča. Pre všetky nasledujúce vklady použite transakciu „Vklad„, pozrite si odsek nižšie.

https://go.affilmaster.com/scripts/sale.php?TotalCost={amount}&Currency=CZK&ActionCode=ftd&ProductID=ftd&Data1={customerID}&OrderID={orderID-123XYZ}&VisitorID={clickID}&CampaignID={campaignID}&Data5={MD5hash}
  • Pre TotalCost – zadajte hodnotu vkladu v EUR.
  • Pre Currency – definujte „EUR“.
  • Pre ActionCode – definujte „ftd“.
  • Pre ProductID – definujte „ftd“.
  • Pre Data1 – zadajte ID zákazníka. (Ak spravujete viacero kasín, uistite sa, že táto hodnota je jedinečná pre všetkých vašich klientov)
  • Pre OrderID – vygenerujte alebo prepíšte jedinečné ID transakcie, ktoré je dostatočne zložité, aby nedošlo k duplicite.
  • Pre VisitorID – prepíšte 32-miestny hash, ktorý ste získali zo súboru cookie návštevníka, a majte ho uložený v DB pre aktuálneho hráča.
  • Pre CampaignID – zadajte ID kampane, ktoré ste dostali od našej podpory a ktoré je jedinečné pre každé kasíno.
  • Pre Data5 – vypíšte zašifrovanú hodnotu v tejto kombinácii vrátane čiarok bez úvodzoviek „TotalCost,OrderID,SecretKey“ aktuálnej transakcie pomocou MD5 Hash. Hodnotu „SecretKey“ dostanete na požiadanie od našej podpory. (Výslednú hodnotu pošlite v Data5 len vo formáte s malými písmenami).

Vklad

Ak chcete sledovať vklady hráča, musíte pri potvrdení druhého a každého ďalšieho úspešného vkladu hráča uskutočniť volanie S2S.

https://go.affilmaster.com/scripts/sale.php?TotalCost={amount}&Currency=CZK&ActionCode=deposit&ProductID=deposit&Data1={customerID}&OrderID={orderID-123XYZ}&VisitorID={clickID}&CampaignID={campaignID}&Data5={MD5hash}
  • Pre TotalCost – zadajte hodnotu vkladu v EUR.
  • Pre Currency – definujte “EUR”.
  • Pre ActionCode – definujte “deposit”.
  • Pre ProductID – definujte “deposit”.
  • Pre Data1 – zadajte ID zákazníka. (Ak spravujete viacero kasín, uistite sa, že táto hodnota je jedinečná pre všetkých vašich klientov)
  • Pre OrderID – vygenerujte alebo prepíšte jedinečné ID transakcie, ktoré je dostatočne zložité, aby nedošlo k duplicite.
  • Pre VisitorID – prepíšte 32-miestny hash, ktorý ste získali zo súboru cookie návštevníka, a majte ho uložený v DB pre aktuálneho hráča.
  • Pre CampaignID – zadajte ID kampane, ktoré ste dostali od našej podpory a ktoré je jedinečné pre každé kasíno.
  • Pre Data5 – vypíšte zašifrovanú hodnotu v tejto kombinácii vrátane čiarok bez úvodzoviek „TotalCost,OrderID,SecretKey“ aktuálnej transakcie pomocou MD5 Hash. Hodnotu „SecretKey“ dostanete na požiadanie od našej podpory. (Výslednú hodnotu pošlite v Data5 len vo formáte s malými písmenami).

Net Gaming Revenue (NGR)

Ak chceme sledovať NGR, musíme vykonať volanie S2S v situácii, keď sčítavame aktuálnu reláciu hráča. Prehry majú kladnú hodnotu a výhry zápornú hodnotu pre konečný súčet.

Ak neviete, ako vypočítať NGR, pomôžeme vám v tomto článku.

https://go.affilmaster.com/scripts/sale.php?TotalCost={amount}&Currency=CZK&ProductID=turnover&Data1={customerID}&OrderID={orderID-123XYZ}&VisitorID={clickID}&CampaignID={campaignID}&Data5={MD5hash}
  • Pre TotalCost – zadajte výslednú hodnotu v EUR.
  • Pre Currency – definujte „EUR“.
  • Pre ProductID – definujte „turnover“.
  • Pre Data1 – zadajte ID zákazníka. (Ak spravujete viacero kasín, uistite sa, že táto hodnota je jedinečná pre všetkých vašich klientov)
  • Pre OrderID – vygenerujte alebo prepíšte jedinečné ID transakcie, ktoré je dostatočne zložité, aby nedošlo k duplicite.
  • Pre VisitorID – prepíšte 32-miestny hash, ktorý ste získali zo súboru cookie návštevníka, a majte ho uložený v DB pre aktuálneho hráča.
  • Pre CampaignID – zadajte ID kampane, ktoré ste dostali od našej podpory a ktoré je jedinečné pre každé kasíno.
  • Pre Data5 – vypíšte zašifrovanú hodnotu v tejto kombinácii vrátane čiarok bez úvodzoviek „TotalCost,OrderID,SecretKey“ aktuálnej transakcie pomocou MD5 Hash. Hodnotu „SecretKey“ dostanete na požiadanie od našej podpory. (Výslednú hodnotu pošlite v Data5 len vo formáte s malými písmenami).
  • NGR nemá definovaný žiadny ActionCode!

Objem stávok

Ak chcete sledovať objem stávok, musíte vykonať volanie S2S v situácii, keď počítate aktuálnu reláciu hráča. Odporúčame použiť súčet všetkých stávok alebo zatočení, ktoré hráč vykonal za poslednú hodinu.

https://go.affilmaster.com/scripts/sale.php?TotalCost={amount}&Currency=CZK&ProductID=bets&Data1={customerID}&OrderID={orderID-123XYZ}&VisitorID={clickID}&CampaignID={campaignID}&Data5={MD5hash}
  • Pre TotalCost – zadajte výslednú hodnotu súčtu stávok a otáčok v EUR.
  • Pre Mena – definujte „EUR“.
  • Pre ActionCode – definujte „bets“.
  • Pre ProductID – definujte „bets“.
  • Pre Data1 – zadajte ID zákazníka. (Ak spravujete viacero kasín, uistite sa, že táto hodnota je jedinečná pre všetkých vašich klientov)
  • Pre OrderID – vygenerujte alebo prepíšte jedinečné ID transakcie, ktoré je dostatočne zložité, aby nedošlo k duplicite.
  • Pre VisitorID – prepíšte 32-miestny hash, ktorý ste získali zo súboru cookie návštevníka, a majte ho uložený v DB pre aktuálneho hráča.
  • Pre CampaignID – zadajte ID kampane, ktoré ste dostali od našej podpory a ktoré je jedinečné pre každé kasíno.
  • Pre Data5 – vypíšte zašifrovanú hodnotu v tejto kombinácii vrátane čiarok bez úvodzoviek „TotalCost,OrderID,SecretKey“ aktuálnej transakcie pomocou MD5 Hash. Hodnotu „SecretKey“ dostanete na požiadanie od našej podpory. (Výslednú hodnotu pošlite v Data5 len vo formáte s malými písmenami).

Bonus

Aby bolo možné sledovať príjmy hráča z bonusu, je potrebné uskutočniť volanie S2S, keď sa bonus používateľa stane výdavkom kasína, t. j. keď buď prejde časovým testom, alebo splní požiadavky na stávkovanie, a preto môže byť vyplatený z hráčskeho účtu mimo kasína na bankový účet hráča.

https://go.affilmaster.com/scripts/sale.php?TotalCost={amount}&Currency=CZK&ActionCode=bonus&ProductID=bonus&Data1={customerID}&OrderID={orderID-123XYZ}&VisitorID={clickID}&CampaignID={campaignID}&Data5={MD5hash}
  • Pre TotalCost – zadajte hodnotu bonusu v EUR
  • Pre Currency – definujte “EUR”.
  • Pre ActionCode – definujte “bonus”.
  • Pre ProductID – definujte “bonus”.
  • Pre Data1 – zadajte ID zákazníka. (Ak spravujete viacero kasín, uistite sa, že táto hodnota je jedinečná pre všetkých vašich klientov)
  • Pre OrderID – vygenerujte alebo prepíšte jedinečné ID transakcie, ktoré je dostatočne zložité, aby nedošlo k duplicite.
  • Pre VisitorID – prepíšte 32-miestny hash, ktorý ste získali zo súboru cookie návštevníka, a majte ho uložený v DB pre aktuálneho hráča.
  • Pre CampaignID – zadajte ID kampane, ktoré ste dostali od našej podpory a ktoré je jedinečné pre každé kasíno.
  • Pre Data5 – vypíšte zašifrovanú hodnotu v tejto kombinácii vrátane čiarok bez úvodzoviek „TotalCost,OrderID,SecretKey“ aktuálnej transakcie pomocou MD5 Hash. Hodnotu „SecretKey“ dostanete na požiadanie od našej podpory. (Výslednú hodnotu pošlite v Data5 len vo formáte s malými písmenami).

Výber

Na sledovanie výberov hráčov je potrebné vykonať volanie S2S, keď používateľ nezvratne potvrdí výber zo svojho hráčskeho účtu.

https://go.affilmaster.com/scripts/sale.php?TotalCost={amount}&Currency=CZK&ActionCode=withdrawal&ProductID=withdrawal&Data1={customerID}&OrderID={orderID-123XYZ}&VisitorID={clickID}&CampaignID={campaignID}&Data5={MD5hash}
  • Pre TotalCost – zadajte hodnotu výberu v EUR.
  • Pre Currency – definujte “EUR”.
  • Pre ActionCode – definujte “withdrawal”.
  • Pre ProductID – definujte “withdrawal”.
  • Pre Data1 – zadajte ID zákazníka. (Ak spravujete viacero kasín, uistite sa, že táto hodnota je jedinečná pre všetkých vašich klientov)
  • Pre OrderID – vygenerujte alebo prepíšte jedinečné ID transakcie, ktoré je dostatočne zložité, aby nedošlo k duplicite.
  • Pre VisitorID – prepíšte 32-miestny hash, ktorý ste získali zo súboru cookie návštevníka, a majte ho uložený v DB pre aktuálneho hráča.
  • Pre CampaignID – zadajte ID kampane, ktoré ste dostali od našej podpory a ktoré je jedinečné pre každé kasíno.
  • Pre Data5 – vypíšte zašifrovanú hodnotu v tejto kombinácii vrátane čiarok bez úvodzoviek „TotalCost,OrderID,SecretKey“ aktuálnej transakcie pomocou MD5 Hash. Hodnotu „SecretKey“ dostanete na požiadanie od našej podpory. (Výslednú hodnotu pošlite v Data5 len vo formáte s malými písmenami).

Ďalšie informácie o hodnote celkových nákladov

Tu nájdete dôležité informácie o formátovaní odoslanej hodnoty TotalCost=

  • Desatinná hodnota musí byť oddelená bodkou a nie čiarkou.
    • 99,56 -> 99.56
  • Hodnota nesmie mať viac ako 2 desatinné miesta. Hodnotu zaokrúhlite na najbližšiu vyššiu číslicu.
    • 52.456 -> 52.46
    • 52.454 -> 52.45
  • Hodnota nesmie obsahovať prázdne desatinné miesta
    • 0.00 -> 0
    • 100.00 -> 100
    • 27.30 -> 27.3
    • 43.260 -> 43.26

Relácie

Množstvo údajov sa líši v závislosti od typu udalosti. Vkladov a registrácií je oveľa menej ako záznamov NGR a stávok a nemusia sa zhromažďovať vo väčšom „balíku„. Odporúčame zasielať objem NGR a stávok vo väčšom „balíku„.

Ako často odporúčame zasielať jednotlivé údaje:

  1. Vklad, FTD, bonus, výber – okamžite
  2. Overená registrácia – okamžite
  3. NGR relácia, objem stávok – súčet transakcií za hodinu

Príklad PostBacku

Príklad PostBacku pre vklad 4.2 EUR:

https://go.affilmaster.com/scripts/sale.php?TotalCost=4.2&Currency=EUR&ActionCode=deposit&ProductID=deposit&Data1=tester%40affilmaster.com&OrderID=Test_23_DE23_UNI_765454&VisitorID=oumSQ9nsZwtS4NjGAoqqenRiC0GviMu3&CampaignID=aa358615&Data5=5dc7ccbbe2dc29fd518433d6459b031f

Metóda JSON

Na sledovanie predaja musíte použiť priamo volanie scripts/track.php … viac informácií a definície parametrov tu:

Transakcia „Vklad“ by sa v tomto formáte odoslala ako „sale“:
[{“ac”:”deposit”,”t”:”100″,”o”:”OrderID-123XYZ”,”p”:”deposit”,”d1″:”customerID”,”cr”:”CZK”}]

Po použití funkcie url_encode() bude „sale“ vyzerať takto:
%5B%7B%22ac%22%3A%22deposit%22%2C%22t%22%3A%22100%22%2C%22o%22%3A%22OrderID-123XYZ%22%2C%22p%22%3A%22deposit%22%2C%22d1%22%3A%22customerID%22%2C%22cr%22%3A%22CZK%22%7D%5D

Výsledná adresa URL bude vyzerať takto:

https://go.affilmaster.com/scripts/jdvy4d2.php?visitorId=ouSQ9nsZwtS4oNjGAoqqenRiC0GviMu3&accountId=&url=&referrer=&tracking=1&getParams=&ip=&sale=%5B%7B%22ac%22%3A%22deposit%22%2C%22t%22%3A%22100%22%2C%22o%22%3A%22OrderID-123XYZ%22%2C%22p%22%3A%22deposit%22%2C%22d1%22%3A%22customerID%22%2C%22cr%22%3A%22CZK%22%7D%5D