Check User Referral Issues
This API call will give the answers for questions raised from customers (End users) like:
- I referred a friend; he signed up – we did not get the credits! Why?
- My friend got the reward, but I did not. Why so?
- My friend has done 5 transactions, but I am not getting my rewards. Why?
and many such typical questions which are common occurrences when you run Growth Hacks that offer incentives to your users.
Note: This call has a rate limit of 10 per minute.
Base URL https://api.appvirality.com
POST v2_1/checkuserreferralissues/[API Key]
Content-Type application/json
Input i.e. Request
{
"apikey":"176502556c624614b913a62400ab4d7e",
"privatekey":"8b05ee42d9c941698bbba44c00cc32d1",
"referrerinput":"referrer@martinz.com",
"friendemail":"friend@martinz.com",
"campaignid":"283
}
| Input Params | Description |
|---|---|
| apikey | API Key of the App Get it from Dashboard >> App Details |
| privatekey | Private key for API requests Get it from: Dashboard >> App Details >> Click App Settings >> Scroll down to Advanced Settings |
| referrerinput | Email id or referral code of the referrer |
| friendemail | Email id of the friend |
| campaignid (optional) |
Campaign id of the users |
Response
{
"success": true,
"statuscode": 24,
"message": "Friend has been marked as an Existing User."
}
| Output Params | Description |
|---|---|
| success | (Boolean) Status of the API call. |
| message | Information regarding the users (referrer and friend) entered in the api request |
| status code | code based on status of the API call |
Status codes which you will see while using Check User Referral issues API
| Status Code | Description |
|---|---|
| 1 | No Friend found for your input. |
| 2 | No Referrer found for your input. |
| 3 | No Friend found for your input. No Referrer found for your input. |
| 4 | Referrer doesn't belong to this campaign (Referrer campaign – XYZReferral). |
| 5 | Self-referral i.e user has referred to himself using the same device/email. |
| 6 | Friend has not entered a referral code. |
| 7 | Referrer and Friend attribution was successful. |
| 8 | Friend has been marked as an Existing User. |
| 9 | Friend has been marked as Suspicious. |
| 10 | Friend has been marked as Blocked. |
| 11 | Referrer has been marked as Blocked. |
| 12 | Referrer has reached the maximum reward capacity. |
| 14 | Conversion event (Install, Signup, ..) was successfully received. |
| 15 | Conversion event (Install, Signup, ..) was not received. |
| 16 | Conversion event was not received. |
| 17 | Friend has been marked as Suspicious because Referrer had been marked as Blocked. |
| 18 | Friend has been marked as Suspicious |
| 19 | Referrer has been marked as Blocked |
| 20 | Friend is already attributed to xyz@email.com. |
| 21 | Friend has been marked as Existing User, attributed to xyz@email.com. |
| 22 | Referrer and Friend attribution was not successful. |
| 23 | Friend was installed prior to the referrer. |
| 24 | Friend has been marked as an Existing User. |
| 25 | Friend has been marked as Existing User by App. |
| 26 | Device is already registered earlier with a different user xyz@email.com. |
| 27 | Friend has not clicked on referral link within the attribution time period. |
| 28 | Friend neither clicked on referral link nor provided referral code. |
| 29 | Either friend has entered a wrong or no referral code. |
| 30 | Friend has clicked referral link and installed from different IP's. |
| 31 | Either friend has not clicked on the referral link OR entered a wrong or no referral code. |
| 32 | Friend entered a wrong referral code – XYZ3723S. |