Skai (Kenshoo) integration: set up your Skai call tracking integration

Skai call tracking sends your daily Infinity call data into Skai by FTP, so you can see your calls in Skai's search marketing dashboards. This lets you optimise PPC bids against call conversions as well as online conversions. This guide covers what Infinity sends to Skai, what you need before you start, and the technical details of the delivery.

What is Skai?

Skai (rebranded from 'Kenshoo') provides a search engine marketing (SEM) platform for campaign management to agencies, advertisers and affiliate marketers internationally. The platform automates the process of building and optimising cross-channel search campaigns.

How the integration works

Skai call tracking works by having Infinity push daily call data into Skai by FTP. This lets you view Infinity's detailed call metrics in Skai's search marketing dashboards. The result is a view of all customer touch points within Skai, so you can optimise PPC bids against call conversions as well as online conversions.

Before the integration, you could only manage bids based on online conversions. Phone calls account for a significant percentage of conversions for most clients, so calls were missing from that view.

With the Skai integration installed, the Infinity tracking code on your website also captures the KClickID of the visitor. This is a Skai unique visitor ID, and it relates to the ad that brought them to your site. When a call occurs, it is tracked against the visitor as normal in the Infinity Platform. The call data is then passed back to Skai, so you can see exactly how your campaigns deliver calls.

Infinity passes each call to Skai with the label 'Call Pass' if the call reached a connected status with Infinity, or 'Call Fail' if the call was not bridged.

What we send to Skai

The Skai FTP report file is a CSV with the following headings. The file contains one row per call in the report date range. No aggregation or attribution takes place, so Skai processes the data internally. The date and time format for all fields is d-m-Y H:i:s, and fields are delimited by a semicolon.

• date_time: start time of the call.
• caller_number: caller ID. Can be empty if needed.
• ct_number: tracked phone number.
• smb_number: destination phone number.
• caller_name: can be empty if needed.
• caller_address: can be empty if needed.
• call_start: start time of the call.
• call_end: start time of the call.
• call_id: a globally unique ID per call.
• call_status: either 'Answered' or 'Not Answered'.
• Skai tracking ID (cookie ID): passed via the URL as k_clickid={kenshoo_cookie}.

Before you start

Before you set up Skai call tracking, gather the following information.

1. Contact your Skai Account Manager to get set up with FTP login details. Note the FTP username and FTP password, as we need these to communicate with your Skai account later.
2. Make sure your Skai account is set up to send the k_clickid parameter in your URLs.
3. Decide at which time each day it is appropriate for us to push the data into Skai by FTP (for example, 6am). You may want to discuss this with your Skai Account Manager before you decide.
4. Make a note of your Skai Profile ID.

Set up Skai call tracking

When you have gathered the information above, contact the Infinity Support Team. They will configure the integration on your behalf. Due to the complexity of setting it up, the feature is not self-service.

Your Infinity package also needs to include an additional integration. For more information, contact support@infinity.co.

Note: No changes to the Infinity JavaScript tracking code are required to enable the Skai integration.

Skai integration: technical information

FTP delivery

The Skai reports are sent by FTP to Skai's server. This is the default FTP location in the KenshooFtp plugin, although it can be overridden for testing purposes. The filename format is:

{profileID}yyyy_MM_dd.csv

{profileID}yyyy_MM_dd.csv

Tracking IDs

Skai tracking IDs are provided on landing URLs using the k_clickid parameter. This is configured as a pass-through variable for the IGRP (installation) automatically when you set up a Skai integration. The Skai FTP plugin looks for pt_k_clickid in the trigger properties to extract the Skai tracking ID.

Report dates and time zones

The integration operates in UTC time. If you are an international client, or your clocks have changed due to daylight saving, consider this. The Skai FTP plugin is scheduled to run daily. It looks at the report run date and extracts the previous day's data from the export API, according to the IGRP's (installation's) time zone.

The file is named after the data it contains, not the run date. For example, a report run on 6th July 2023 contains data for 5th July 2023 and is named as follows:

{profileID}2019_07_05.csv

{profileID}2019_07_05.csv

Need more help?

Read the Calls Log to see where your call data appears in the Infinity Platform, or the CRM integrations overview for other integrations. If you're still stuck, get in touch with your account team or email support@infinity.co.