Help Center

| Submit or View Help Requests | Developer Docs |

View desktop instructions
View mobile app instructions
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.

  1. From the left navigation menu, select ellipsis-v-solid.svg [Menu] → Settings.

  2. On the right, under Tracking, select Event Types.

  3. Hover your cursor over the event type you want to submit data for, then select View/Edit.

  4. Next to Returns Processing, select pencil-alt-solid.svg [Edit].

  5. Select Automate returns processing (advanced) → Batch upload.

  6. From the drop-down list, select an FTP connection.

  7. 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.

  8. 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

Field

Type

Required

Description

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.

  CampaignId,MediaId,EventDate,ActionTrackerId,CallProvider,CallSessionId,CallerId,CalledPhoneNumber,CallDuration,TalkDuration,AdId,CallStatus,CallerPhoneNumberCountry,CalledPhoneNumberCountry,SubId1,SubId2,SubId3,ClickId,City,Region,Zip,RepeatCaller,PhoneType,CallRecording,IvrDuration,Keypresses,Key1,Key2,Key3,Key4,OptInSms,UserAgent,DispositionName,SaleAmount,ReferenceId,CustomConversionEvent1Name,CustomConversionEvent2Name,CustomConversionEvent3Name,CustomConversionEvent1Value,CustomConversionEvent2Value,CustomConversionEvent3Value,VendorEventId,PromoNumberDescription,CustomCallEvent1Name,CustomCallEvent2Name,CustomCallEvent3Name,CustomCallEvent1Value,CustomCallEvent2Value,CustomCallEvent3Value
1000,987654,2022-03-01T04:10:49-05:00,19283,Acme,1A5B9C4D0E0F7G1H0I,8005550100,11,8,

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.