How it works
Roistat will import both deals from the Deals and Leads pages in Bitrix24 if you set up the Bitrix24 (leads + deals) type of integration. If you need Roistat to import data only from the Deals page, read Bitrix24 (deals).
The tracking code serves to collect and send visitors' data to Roistat from a website.
Firstly, the tracking code should be placed on each web page you wish to track. Having added the code will set the roistat_visit variable containing a visit ID into the cookie. Once you have successfully installed the tracking code on your website, the Promo Code functionality will be available.
Secondly, it's necessary to customize lead export from Roistat to Bitrix24 by adding the value of the roistat_visit cookie to the deal. We developed an easy-to-manage module to export leads. It won't take you a lot to set it up.
In summary, when a visitor creates some request on your website, a new deal is created in your CRM and characterized among others by the visit ID (the roistat_visit variable) contained in the roistat field. Otherwise, if a client is calling to make an order, a manager may ask him/her for a promotional code and put it down into the custom field on a deal card; promo code appearance needs special setup.
Step 1. Set up tracking code
To view the Roistat tracking code, navigate to Settings → Tracking Code:
Insert the code between the <body></body> tag of your web pages. It can be placed next to the Google Analytics counter or any others.
The tracking code must be placed into the HTML code of every page of your website.
Consequently, all visits will be counted and analyzed in Analytics.
Do not insert more than one counter in a page to prevent inaccurate data entry.
Step 2. Add roistat field in Bitrix24
Bitrix24 deals/leads should be characterized among others by visitor IDs in order to be linked to visits. This requires the roistat field to be added to Bitrix24 entities Lead and Deal.
To do this, in your Bitrix24 account navigate to CRM → Settings → Form and report settings → Custom fields → Deal/Lead and click Add field:
Create the following field:
Step 3. Configure Roistat access to Bitrix24
To integrate with Roistat, it's necessary to install our application.
Mind that only a user with administrator rights can install applications in Bitrix24.
In Roistat, open Settings → Integrations and choose Bitrix24 (leads + deals) from the Available integrations drop-down menu. Click Select to save the integration type.
Enter your Bitrix24 project URL into the corresponding field (the URL usually looks like http://<project>.bitrix24.com) and click Application install:
The installation window will then open in your Bitrix24 account. Click the Install button:
In Roistat, click the Sign in button to save your Bitrix24 authorization settings:
Once the sign-in settings has been saved, integration advanced settings will be displayed:
You may specify any Bitrix24 field that corresponds to the Roistat revenue field, if necessary.
To do this, select a field name from the drop-down menu.
First cost field
You may specify any Bitrix24 field that corresponds to the Roistat first cost and profit fields, if necessary.
To do this, select a field name from the drop-down menu.
Responsible for deals
You may specify any responsible managers to import only their deals to Roistat, if necessary.
Managers' IDs separated by comma
The type of a filter.
By default, all deals and leads are exported from your Bitrix24 account.
You may configure what specific fields should be exported from Bitrix24, if necessary. To do this, select a field name from the drop-down menu.
The value of a filter which is applied to select specific deals and leads to be exported from Bitrix24 to Roistat.
It must be specified if filtration is on.
The value of a filtration field.
Use regular expressions if you understand them.
Once you have specified all the information needed and saved it by clicking Save, Bitrix24 statuses will be imported to Roistat. You should correlate them with the Roistat statuses.
Step 4. Arrange statuses
Once Bitrix24 has integrated with Roistat, you'll need to arrange deals and leads statuses:
Not registered: waste leads or duplicate deals. Do not delete such deals to provide reliable statistics. You can gather them all in one status, e.g. Waste;
Processing: deals being in process, not completed, e.g. negotiations or product packaging;
Paid: deals that are paid or very likely to be paid;
Rejected: when a client rejects the purchase or requests a refund.
Just drag and drop a status to the box you wish.
Quote statuses will be imported to Roistat as well. It's a Bitrix24 API shortcoming, so that you should leave these statuses in the Not registered group.
Moreover, you should leave the Converted status in the Not registered group otherwise leads and deals converted from those leads will overlap.
All the statuses can be distributed the following way:
Step 5. Automatic leads export
In this case, the commentary field of a lead should contain the value of the roistat_visit cookie.
Below is an example of the string that contains the value of this cookie:
The string to insert into the lead commentary field should have the format as follows:
When created leads should be automatically exported from your website to Bitrix24. For this to happen, we offer you a complete solution: deal proxying.
When a visitor creates some request on your website, a new deal is automatically created in Bitrix24 as well, and a backup copy of the lead data is stored in your Roistat account. Keeping this in mind, you will not have to worry that Bitrix24 can be off-line sometimes. In any case, all the data is stored and then re-exported to Bitrix24 some time later.
To set up deal proxying, insert the following code snippet into the file that processes deal forms on your website (e.g. sends data to some e-mail):
Verify the integration
When a client creates some request on your website, a new lead will be created in Bitrix24 and will have a commentary with the roistat code.