Submit Call Conversion Data via FTP
Brands that are tracking call conversion data can batch report that data in a .CSV file that is uploaded to the Impact FTP server with unique credentials.
Call conversion data that is batch reported to impact.com via FTP is typically processed within 24 hours, and will appear as pending actions within the impact.com platform.
Upload your .CSV file
This feature is only accessible to specific impact.com editions or add-ons. Contact us to upgrade your account and get access!
To submit to impact.com's FTP server, you will need to retrieve account credentials first. Follow the instructions below to learn how to have your existing credentials emailed to you.
Note: If you haven't received the email, contact the person who created your impact.com account, alternatively contact support.
From the top navigation bar, select
[User profile] → Settings. In the right column, under Tracking, select Event Types.
Hover your cursor over the event type you want to submit data for, then select
[More] → View/Edit.Next to Returns Processing, select
[Edit].Select Automate returns processing (advanced) → Batch upload.
Choose an FTP connection by selecting
[Unchecked box].Alternatively, select Create new connection. Learn how to create a data upload connection.
Once you have your FTP credentials, use an FTP client to connect to impact.com.
The FTP address is
ftp://import.impact.com/{name}You can use an existing set of credentials or an auto-generated set of credentials.
Once connected, upload your file to the main directory of the server.
Call conversion file format specs
Call conversion data is populated in a .CSV file. Refer to the spec below for all required column headers needed in your .CSV file.
Call conversion file format reference
CampaignId
Integer
Required
Unique identifier for the campaign (or program) that the call conversion is associated with.
MediaId
Integer
Required
Unique identifier for the partner or media source.
EventDate
datetime (ISO 8601)
Required
ISO 8601 format of the date and time when the call conversion event occurred.
ActionTrackerId
Integer
Required
Unique identifier for the action tracker (i.e., event type) that's tracking the phone call.
CallProvider
String
Required
The vendor or client who is sending the call event data
CallSessionId
String
Required
A unique session ID that the vendor or client uses to identify the call.
CallerId
String
Required
The phone number of the originating call, used to match the final conversion.
CalledPhoneNumber
String
Required
The destination phone number or the phone number that received the call.
CallDuration
String
Required
Total duration (in seconds) of the call.
TalkDuration
String
Required
Actual talk duration (in seconds) of the call.
AdId
Integer
Optional
Unique identifier for the ad associated with the call conversion.
CallStatus
String
Optional
This value indicates the final outcome of the call. If the field is not present in request, we make it ANSWER by default. Valid values are:
UNKNOWN_CALLERID
FAILURE
CONGESTION
INCOMPLETE
CANCEL
IVR_DROPOFF
NO_TRANSFER_ATTEMPT
ANSWER
CallerPhoneNumberCountry
String
Optional
Two-digit country code for the originating phone number (ISO 3166 alpha-2). When NULL, defaults to US.
CalledPhoneNumberCountry
String
Optional
Two-digit country code for the called phone number (ISO 3166 alpha-2). When NULL, defaults to US.
SubId1
String
Optional
This value is specific and only available to the media partner. This is the placeholder where Media Partner can add data points that they want impact.com to report back to them.
SubId2
String
Optional
SubId3
String
Optional
ClickId
String
Optional
Unique case-sensitive identifier generated by impact.com of a referring click, used to construct a consumer journey.
Country
String
Optional
Country of the CallerId - as identified by the call tracking vendor.
City
String
Optional
City of the CallerId - as identified by the call tracking vendor.
Region
String
Optional
Region of the CallerId - as identified by the call tracking vendor.
Zip
Integer
Optional
Zip of the CallerId - As identified by the call tracking vendor.
RepeatCaller
String
Optional
Repeat vs New call to indicate whether the caller was recorded as a repeat caller by the call tracking vendor.
PhoneType
String
Optional
The type of phone (i.e., landline, mobile).
CallRecording
String
Optional
Unique URL of the call recording.
IvrDuration
String
Optional
Duration in seconds that the call spent in the IVR tree.
Keypresses
String
Optional
List of unique keynames that were pressed during the call.
Key1
String
Optional
Name of the first key that was pressed.
Key2
String
Optional
Name of the second key that was pressed.
Key3
String
Optional
Name of the third key that was pressed.
Key4
String
Optional
Name of the fourth key that was pressed.
TrafficSource
String
Optional
Source of the transaction (referring media source).
OptInSms
String
Optional
Whether the caller opted in to receive an SMS promotion.
UserAgent
String
Optional
The user agent of the conversion generator.
DispositionName
String
Optional
The Conversion Event Name.
SaleAmount
Currency
Optional
If Sale Conversion, Sale Amount
ReferenceId
String
Optional
Customer Disposition Code for reference.
CustomConversionEvent1Name
String
Optional
Custom name for reporting on conversion events
CustomConversionEvent2Name
String
Optional
CustomConversionEvent3Name
String
Optional
CustomConversionEvent1Value
String
Optional
Custom value for reporting on conversion events
CustomConversionEvent2Value
String
Optional
CustomConversionEvent3Value
String
Optional
VendorEventId
String
Optional
Will be unique for call event and unique for the conversion event.
PromoNumberDescription
String
Optional
Describes the called phone number
CustomCallEvent1Name
String
Optional
Custom name for reporting on call events
CustomCallEvent2Name
String
Optional
CustomCallEvent3Name
String
Optional
CustomCallEvent1Value
String
Optional
Custom value for reporting on call events
CustomCallEvent2Value
String
Optional
CustomCallEvent3Value
String
Optional
Example CSV
Copy this example CSV data to use for your file import.
Last updated
Was this helpful?