Conversion Import

HTTP method End Point Description
POST /network/conversion-import Upload / Edit Conversions

Request Parameters

If request is sent without click_id it will by default create a new conversion

Field Type Description Required
conversion_id string (24 character id) vNative Conversion ID No (Yes when editing)
campaign_id int or string Either the numeric id or vNative 24 character campaign id Yes (If creating new conversion)
publisher_id string Either the numeric id of vNative 24 character publisher ID Yes (if creating new conversion)
goal_id string 24 character ID Goal ID associated with this campaign No
txn_id string Unique identifier provided No
sub1 string Sub ID 1 No
sub2 string Sub ID 2 No
sub3 string Sub ID 3 No
sub4 string Sub ID 4 No
sale_amount float Sale Amount for the campaign No
payout float Payout for conversion No
revenue float Revenue for conversion No
currency string Default Value = USD No
method string Default Value = acquisition (Other Values - pixel, app_install) No
ipaddr string IP address from which this conversion was requested No
status string Default Value - approved (Other value - cancelled, pending, rejected) No
created string Format = YYYY-MM-DD H:i:s (The time for recording conversion will be considered according to network timezone) No
referer string To store the referring page No

Response body parameters

curl -i -X POST \
   -H "X-Api-Key: {key}" \
   -H "Content-Type:application/json" \
   -d \
  "conversions": [
      "status": "approved"
      "campaign_id": 86,
      "publisher_id": "57c6c75934243d930c8b4581",
      "payout": 2,
      "revenue": 4,
      "currency": "USD",
      "created": "2017-10-26 22:33:00"
}' \

Sample Response

    "success": true,
    "data": {
        "message": "Job has been queued!!",
        "job": {
            "_id": "5c54073a89d4465d2d17cf96",
            "status": "pending",
            "created": {
                "date": "2019-02-01 08:45:46.850000",
                "timezone_type": 1,
                "timezone": "+00:00"

This endpoint will create a background job which will be processed by the system. The status of the job can be viewed using the jobs endpoint


  • Sale Amount will only be considered to calculate payout when the campaign objective is set Sales
  • Valid Sale Currencies = USD, INR, AUD, EUR, TRY, IDR, THB, MYR, PHP, VND, RUR, PLN

  • If Goal ID is passed then payout will be defined by Goal
  • If Both Goal ID and Sale Amount are given then conversion will be marked as Sale

  • If Conversion ID is given then system tries to find conversion with given id and updates it if found

  • If more than 10 errors are generated while importing the conversions then the process will be halted in between

results matching ""

    No results matching ""