Our Convertro destination lets you track customer data from either your website data or your mobile data. When you send data via
analytics.js Segment uses Convertro’s JS library to send
If you are sending data using our mobile libraries, Segment uses their server to server API to send
When you call our identify call we’ll call Convertro’s
trackUser method with the
traits object. If you don’t include the first argument in your
identify call (the
userId) nothing will be sent to Convertro.
Ecommerce events are sent to Convertro as long as they include an
To record the transaction amount to Convertro we’ll pass the
total from your Order Completed event and fall back to
revenue if there’s no
You can also include
properties.repeat as a boolean if you need to specify between repeat and new purchasers.
With a value of
true Segment passes
sale.repeat to Convertro.
If you record
repeat: false Segment passes
sale.new to Convertro.
Convertro has two main attribution models.
- You don’t know which users are new or repeat, so you’ll just send through Order Completed without a
repeatproperty and it will get counted as a
saleevent in Convertro.
- You know which users are new or repeat, and when you pass through the Order Completed event with a
repeatproperty set to
falsewe’ll send through a
sale.newevent to Convertro.
If over the course of your using Convertro, you switch between the first and second attribution model, Segment provide the ability to take advantage of a hybrid attribution model that will send both
sale.repeat when you have a valid
repeat property on the Order Completed event. This is necessary to combine the models and data from your old
sale event with the new
Using Mobile Libraries
In order for your mobile data to flow to Convertro, you want to first insert your Convertro Client Name, Site ID, and Domain into your destination settings.
Important: Convertro requires your Device ID for all API calls. Our mobile libraries automatically collect this value from your device so you do not need to worry about it. Just don’t overwrite your
Convertro only accepts user data that includes a
userId. Thus Segment rejects any anonymous
.identify() calls that does not include the
Convertro does not accept any user traits – meaning that
.identify() calls will be used to tie your Device ID to the userId.
When you call
.track(), Segment sends that event to Convertro by setting the
event_type as the name of your event. If you send a
revenue property, Segment sends that as the
Order Completed events will use the
event_value will be sent as
1 if no revenue value is provided.
We will send this automatically collected
Application Installed event to Convertro’s
For user-property destinations, an identify call will be sent to the destination for each user being added and removed. The property name will be the snake_cased version of the audience name you provide with a true/false value. For example, when a user first completes an order in the last 30 days, we will send an identify call with the property
order_completed_last_30days: true, and when this user no longer satisfies we will set that value to
When the audience is first created an identify call is sent for every user in the audience. Subsequent syncs will only send updates for those users which were added or removed since the last sync.
Supported Sources and Connection Modes
The first step is to make sure Convertro supports the source type and connection mode you’ve chosen to implement. You can learn more about what dictates the connection modes we support here.
To learn more about about Connection Modes and what dictates which we support, see here.
Segment offers an optional Device-based Connection Mode for Mobile data going to Convertro, so that you can use Convertro features that collect data directly from the mobile device. To do this, you must package the Segment-Convertro mobile SDK with the Segment mobile SDK.
Segment lets you change these destination settings from your Segment dashboard without having to touch any code.
Enter your Convertro Account Name
If you’d like to send mobile data to Convertro’s server side integration, please enter your Convertro Client Name
If you’d like to send mobile data to Convertro’s server side integration, please enter your Convertro Domain
Convertro only wants to receive specific events. For each conversion event you want to send to Convertro, put the event name you send to Segment on the left, and the name you want Convertro to receive it as on the right.
Hybrid Attribution Model
This will make Completed Order events always send a
sale event in addition to a
sale.repeat event if it has a boolean
If you’d like to send mobile data to Convertro’s server side integration, please enter your Convertro Site ID
This page was last modified: 07 Apr 2020
Questions? Problems? Need more info? Contact us, and we can help!