New Tracking Structure - Advanced Integrations

Perform Advanced Integrations

Convert provides a way to send visitors and conversion data back to the Convert servers from third-party applications using HTTP requests. This allows you to send conversion data from CRM's, e-commerce, and any system where the conversion does not happen on the same site as the visitor arrives.

Both HTTP POST and the REST API HTTP GET requests can be used to notify the Convert of these conversions. 

You will need to make the requests to the following URL:
https://10000001.metrics.convertexperiments.com/track
Where the10000001 is your project id.

  1. Using the HTTP POST method.

    You will need to submit a POST request that looks like the following:
    {
    "cid":"12345",
    "pid":"12345",
    "seg":{
    "browser":"CH",
    "devices":["DESK"],
    "source":"direct",
    "campaign":"",
    "new":1,
    "ctry":"RO",
    "cust":["123","456"]
    },
    "vid":"1588166554499-0.2020703998482254",
    "ev":[
    {"evt":"viewExp","vars":["12345","6789"],"exps":["ABCD","DEF"]},
    {"evt":"hitGoal","goals":[12345],"vars":["12345","6789"],"exps":["ABCD","DEF"]},
    {"evt":"tr","goals":[12345],"vars":["12345","6789"],"exps":["ABCD","DEF"],"r":123.23,"prc": 2}
    ]
    }:

  2. Using the REST API HTTP GET Method

    Issue a GET Request to the above URL with the above JSON as query string params.

    Eg: https://10024405.metrics.convertexperiments.com/track?cid=12345&pid=12345&seg[browser]=CH&seg[devices][]=DESK&seg[source]=direct&seg[campaign]=test_campaign&seg[new]=1&seg[cust][]=123&seg[cust][]=456&vid=1588166554499-0.2020703998482254&ev[0][evt]=viewExp&ev[0][vars][]=12345&ev[0][vars][]=6789&ev[0][exps][]=ABCD&ev[0][exps][]=DEF&ev[1][evt]=hitGoal&ev[1][goals][]=12345&ev[1][vars][]=12345&ev[1][vars][]=6789&ev[1][exps][]=ABCD&ev[1][exps][]=DEF

 

Parameters explanation:

  1. cid: The account id. 
  2. uid: The project id.
  3. seg: This is a group of properties that can be sent with each event.
    • browser: One of IE, CH, FF, OP, SF, OTH.
    • devices: Device, one or more of DESK, OTHDEV , IPAD, ALLTAB, OTHTAB, OTHPH, IPH, ALLPH.
    • source: One of direct, referral, Search, Campaign.
    • campaign: A string representing a custom campaign.
    • new: 0 if a new visitor in this session, 1 if returning.
    • ctry: Two-letter ISO country code.
    • cust: Array of IDs of custom audiences setup into the project as segments.
  4. vid: Session ID
  5. ev: Group of events that can be sent.
    • evt: event instance which has to be "hitGoal" (conversion of a goal), "viewExp"(view of an experiment's variation),"tr"(transaction).
Need assistance? Start a conversation with our Support Team.
CONVERT MORE

Reliably Convert More Site Visitors, Even If Everything Else is Changing in Your Business.

START 15-DAY FREE TRIAL
✓ No Credit Card  ✓ Easy Set-Up  ✓ Access All Features

Comments