Documentatie Cashback

Integrarea aplicatiilor de cashback cu platforma 2Performant: Ghid de integrare API

Aplicatiile de cashback au nevoie de o integrare API cu platforma pentru a putea corela click-urile si conversiile cu conturile utilizatorilor lor. Documentatia poate fi gasita aici:

Lucruri de avut in vedere atunci cand integrezi aplicatia de cashback cu platforma 2Performant:

Statusurile tranzactiilor – disponibile prin API

Pending – un status temporar care apare intre momentul in care comisionul este inregistrat si momentul in care advertiserul proceseaza statusul final.
Approved – un status final, care inseamna ca comanda este valida si definitiva. Valoarea comenzii poate fi ajustata in acest punct. Dupa acest moment, nu mai poate fi modificata.
Rejected – un status final, care inseamna ca aceasta comanda nu a fost valida. Statusul nu mai poate fi modificat ulterior.
Paid – indica faptul ca acel comision a fost platit de catre advertiser si valoarea este disponibila in contul tau pentru retragere.

Odata ce un comision este procesat ca Approved sau Rejected, nu se mai pot face modificari pentru acea instanta. Acesta este statusul final si poate include ajustari de valoare (de exemplu, daca clientul returneaza partial o comanda sau face schimburi in cadrul comenzii).

Daca un comision este Approved, ramane cu acest status pana cand este platit de advertiser, dar nu poate reveni la Pending si nici nu i se mai poate modifica valoarea.

Mai multe detalii despre statusurile comisioanelor gasesti aici.

Timpul pana la plata

Pe platforma exista doua tipuri de programe de afiliere:

PrePaid – se incarca o suma de bani in avans
PostPaid – se factureaza cel putin o data pe luna (de obicei pe 1 ale lunii)

Timpul pana la plata depinde de tipul programului de afiliere:

PrePaid:

Odata ce un comision este inregistrat, suma este retrasa automat din contul advertiserului.
Cand comisionul este procesat si aprobat, suma este transferata in contul afiliatului.

PostPaid:

Cand un comision este procesat si aprobat, devine „Payable” si va fi facturat advertiserului cu urmatoarea sa factura.
Cand advertiserul plateste factura care contine comisionul respectiv, suma este transferata in contul afiliatului.

Timpul pana la plata (Time to payment) este un indicator transparent, vizibil in statisticile fiecarui program de afiliere (media ultimelor 6 luni):

time to payment

Cand si cum sunt procesate comisioanele?

Generarea link-urilor

Un link de afiliat are urmatoarea structura:

//event.2performant.com/events/click? – evenimentul principal, care este static
ad_type=quicklink – tipul de reclama, care poate fi quicklink, banner sau product (recomandat: quicklink)
aff_code=xxxxxxxxx – codul tau unic de afiliat
unique=xxxxxxxxx – identificatorul unic al fiecarui advertiser, care trebuie sa fie congruent cu redirect_to=
redirect_to=http%3A//advertiserstore.ro/ (sau .com sau alta extensie a magazinului) – destinatia pe magazinul online al advertiserului unde vrei sa trimiti utilizatorul
st=tag – tag-uri custom unde poti adauga informatii diferite, precum ID-ul unic al fiecarui utilizator al tau (functioneaza ca un sub-ID). Mai multe despre tag-uri: Cum adaugi TAG-uri in linkurile de afiliere.

Sfaturi importante

Inainte de a integra orice advertiser in aplicatia ta de cashback, asigura-te ca advertiserul permite cashback-ul ca metoda promotionala.

Intrebari frecvente (FAQs)

Cat timp dureaza pana o tranzactie apare in sistem?

Comisioanele se inregistreaza de obicei instant sau cu un mic delay. Exista insa unele programe speciale pe platforma noastra care pot avea un delay mai mare in inregistrarea comisioanelor (pana la o zi), deoarece sunt integrate cu alte platforme de afiliere.

Unde si care este cea mai sigura si actualizata sursa de informatii despre pauza programului sau schimbari de comision?

Ori de cate ori un program se inchide, ramane fara fonduri sau comisionul se schimba, alertele sunt trimise automat pe emailul setat ca administrativ in cont. De asemenea, orice reducere a comisionului necesita o notificare prealabila de 30 de zile din partea publisher-ului (sau mai putin daca timpul cookie-ului este mai scurt).

Care sunt posibilele motive pentru care o tranzactie nu este urmarita (nu apare in platforma), presupunand ca utilizatorul a urmat pasii obisnuiti, precum click pe link si efectuarea tranzactiei?

Cele mai comune situatii in care o tranzactie nu este urmarita includ:

setarile de confidentialitate ale utilizatorului (de exemplu, blocarea cookie-urilor third-party, mai ales pe iOS)
folosirea anumitor browsere sau programe antivirus care blocheaza activ cookie-urile
comportamentul specific al utilizatorului (efectuarea tranzactiilor pe browsere sau dispozitive diferite, click pe alte linkuri de afiliere inainte de finalizarea comenzii, ceea ce face ca comisionul sa fie atribuit altui afiliat etc.)

Avand in vedere aceste aspecte, poti recomanda utilizatorilor sa:

nu foloseasca aplicatii AdBlock si sa permita cookie-urile third-party
finalizeze comanda in acelasi browser
sa nu dea click pe alte linkuri (de exemplu site-uri cu cupoane/vouchere) inainte de a finaliza comanda

Aveti un advertiser de test unde pot testa click-uri, comisioane, post back si API-ul in general?

Pentru asta, contacteaza-ne la support@2performant.com.

Cum pot obtine un key/token pentru API?

Pentru a putea face orice cerere catre API-ul 2Performant, trebuie mai intai sa te autentifici in platforma:

curl -H "Content-Type: application/json" -X POST -d '{"user":{"email":"mail@example.com","password":"secret"}}' -i https://api.2performant.com/users/sign_in.json

Ca raspuns vei primi mai multe headere care definesc sesiunea ta. Acestea sunt:
access-token | client | expiry | token-type | uid

Dupa primul login prin API, foloseste acest token pentru a accesa toate sesiunile urmatoare.

Foarte important: de fiecare data cand iti schimbi parola sau adresa de email folosita pentru autentificare in contul 2Performant, trebuie sa actualizezi aceste informatii si aici.