View desktop instructions

View mobile app instructions

Submit Call Conversion Data via FTP

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