Invoca: Most-used fields#
The table below gives information about most-used fields that you can import from Invoca. Other fields might also be available in Adverity.
The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.
API name |
Adverity UI name |
Description |
Use in Adverity |
|---|---|---|---|
advertiser campaign |
advertiser campaign |
The name of the marketing campaign associated with an advertiser, used to track and manage calls and conversions. |
dimension |
advertiser campaign id (invoca id) |
advertiser campaign id (invoca id) |
The unique Invoca identifier for the advertiser campaign. |
metric |
advertiser id (invoca id) |
advertiser id (invoca id) |
The unique Invoca identifier for the advertiser. |
metric |
advertiser_call_fee_localized |
Advertiser Fees |
The telecommunications fee associated with the transaction, specific to the advertiser. |
metric |
advertiser_campaign_id |
Advertiser Campaign ID (Invoca ID) |
The unique Invoca identifier for the advertiser campaign. |
metric |
advertiser_campaign_id_from_network |
Advertiser Campaign ID |
The campaign ID as identified by the network and associated with the advertiser campaign. |
metric |
advertiser_campaign_name |
Advertiser Campaign |
The name of the advertiser campaign. |
dimension |
advertiser_id |
Advertiser ID (Invoca ID) |
The unique Invoca identifier for the advertiser. |
metric |
advertiser_id_from_network |
Advertiser ID |
The advertiser ID as identified by the network and associated with the Invoca advertiser. |
metric |
advertiser_payin_localized |
Earned |
The amount paid in by the advertiser. |
metric |
affiliate id (invoca id) |
affiliate id (invoca id) |
The unique Invoca identifier for the affiliate. |
dimension |
affiliate_call_volume_ranking |
Affiliate Volume Ranking |
The network’s ranking of an affiliate’s call volume, on a scale of 0 to 5. |
metric |
affiliate_commissions_ranking |
Affiliate Commissions Ranking |
The network’s ranking of an affiliate’s commissions, on a scale of 0 to 5. |
metric |
affiliate_conversion_rate_ranking |
Affiliate Conversion Rate Ranking |
The network’s ranking of an affiliate’s conversion rate, on a scale of 0 to 5. |
metric |
affiliate_id |
Affiliate ID (Invoca ID) |
The unique Invoca identifier for the affiliate. |
dimension |
affiliate_id_from_network |
Affiliate ID |
The affiliate ID as identified by the network and associated with the Invoca affiliate. |
dimension |
affiliate_name |
Affiliate |
The name of the affiliate. |
dimension |
affiliate_payout_localized |
Paid |
The amount paid out to the affiliate. |
metric |
brand |
brand |
The name of the advertiser or the overarching business entity associated with the call transaction. |
dimension |
call start time |
call start time |
The date and time when the call began, presented in the API user’s local time zone along with the offset from GMT. This is used for filtering and sorting call transactions. |
dimension |
call start time (utc timestamp) |
call start time (utc timestamp) |
The start time of the call as a UTC timestamp, represented in milliseconds since January 1, 1970. |
metric |
call_fee_localized |
Fees |
The telecommunications fee associated with the transaction. |
metric |
caller id |
caller id |
The phone number of the caller. |
dimension |
calling_phone_number |
Caller ID |
The phone number of the caller, formatted as 12 characters, such as 866-555-1234. This field represents the unique identifier for the calling party. |
dimension |
city |
City |
The city where the transaction originated. |
dimension |
complete_call_id |
Call Record ID |
A globally unique identifier for the entire call record that this transaction is a part of. |
dimension |
connect_duration |
Connected Duration |
The duration in seconds that the call was connected to the call center. |
metric |
corrected_at |
Corrected At |
[Correction only] The date and time when the transaction was corrected, displayed in the user’s time zone with a GMT offset. |
dimension |
corrects_transaction_id |
Corrects Call |
[Correction only] The ID of the original transaction that this entry corrects, with the current row containing the updated values. |
dimension |
destination_phone_number |
Destination Phone Number |
The phone number to which the call was transferred. |
dimension |
duration |
Total Duration |
The total duration of the call in seconds, including any time spent in an IVR. |
metric |
dynamic_number_pool_referrer_ad |
AdWords Ad |
The headline copy of the Google AdWords Ad associated with the call. |
dimension |
dynamic_number_pool_referrer_ad_group |
AdWords Ad Group |
The name of the Google AdWords Ad Group. |
dimension |
dynamic_number_pool_referrer_ad_group_id |
AdWords Ad Group ID |
The ID of the Google AdWords Ad Group. |
metric |
dynamic_number_pool_referrer_ad_id |
AdWords Ad ID |
The ID of the Google AdWords Ad. |
dimension |
dynamic_number_pool_referrer_keyword_match_type |
AdWords Keyword Match Type |
The match type (e.g., broad, phrase, exact) for the Google AdWords keyword. |
dimension |
dynamic_number_pool_referrer_referrer_campaign |
AdWords Campaign |
The name of the Google AdWords Campaign. |
dimension |
dynamic_number_pool_referrer_referrer_campaign_id |
AdWords Campaign ID |
The ID of the Google AdWords Campaign. |
metric |
dynamic_number_pool_referrer_search_engine |
Adwords Search Engine |
The search engine that referred the call (e.g., Google, Bing). |
dimension |
dynamic_number_pool_referrer_search_keywords |
Adwords Keywords |
The search keywords used by the caller that led to the call. |
dimension |
dynamic_number_pool_referrer_search_keywords_id |
AdWords Keywords ID |
The ID of the Google AdWords keyword. |
dimension |
dynamic_number_pool_referrer_search_type |
Adwords Search Type |
Indicates whether the search leading to the call was Paid or Organic. |
dimension |
fees |
fees |
The telecommunications fee associated with the transaction. |
metric |
hangup_cause |
End of Call Reason |
Indicates who ended the call and the manner in which it was ended. |
dimension |
ivr duration |
ivr duration |
The duration in seconds that the call spent within the Interactive Voice Response (IVR) tree. |
metric |
ivr_duration |
IVR Duration |
The duration in seconds that the call spent within the Interactive Voice Response (IVR) tree. |
metric |
keypress_1 |
Key 1 |
The name of the first key pressed by the caller during the IVR. |
dimension |
keypress_2 |
Key 2 |
The name of the second key pressed by the caller during the IVR. |
dimension |
keypress_3 |
Key 3 |
The name of the third key pressed by the caller during the IVR. |
dimension |
keypress_4 |
Key 4 |
The name of the fourth key pressed by the caller during the IVR. |
dimension |
keypresses |
Keypresses |
A list of unique keynames that were pressed during the call. |
dimension |
margin_localized |
Margin |
The calculated margin, representing the difference between the advertiser’s pay-in and the affiliate’s payout. |
metric |
media type |
media type |
The media type associated with the transaction source. |
dimension |
media_type |
Media Type |
The media type associated with the transaction source. |
dimension |
mobile |
Phone Type |
Indicates if the caller’s phone type is Landline or Mobile, or an empty string if unknown. |
dimension |
opt_in_SMS |
Opt In Sms |
Indicates whether the caller opted in to receive an SMS promotion. |
dimension |
original_order_id |
Order ID |
The identifier of the original sales transaction to which the current record refers, used primarily for sales reporting. |
dimension |
phone type |
phone type |
Indicates if the caller’s phone type is Landline or Mobile. |
dimension |
promo_line_description |
promo_line_description |
Provides additional details about the source of the transaction, specifically related to the promotional number. |
dimension |
qualified_regions |
Qualified Regions |
A list of regions that the caller matched based on geographical criteria. |
dimension |
recording |
Recording |
A URL to the call recording, if available. |
dimension |
region |
Region |
The region (state, province, or country) where the transaction originated. |
dimension |
repeat_calling_phone_number |
Repeat Caller |
Indicates whether the incoming call was from a repeat caller. |
dimension |
revenue |
Revenue (Sale Amount) |
The revenue attributed to the call through Signal revenue proxies or Post Call Events. |
metric |
revenue (sale amount) |
revenue (sale amount) |
The revenue attributed to the call through Signal revenue proxies or Post Call Events. |
metric |
source |
source |
Describes the source of the transaction or call. |
dimension |
start_time_local |
Call Start Time |
The local start time of the call in the API user’s time zone, including the offset from GMT. |
dimension |
start_time_network_timezone |
Call Start Time Network Timezone |
The start time of the call in the network’s time zone, including the offset from GMT. |
dimension |
start_time_network_timezone_xml |
Call Start Time Network Timezone (XML formatted) |
The start time of the call in the network’s time zone, formatted in Soap XML. |
dimension |
start_time_utc |
Call Start Time (UTC timestamp) |
The start time of the call as a UTC timestamp, represented in milliseconds since January 1, 1970. |
metric |
start_time_xml |
Call Start Time (XML formatted) |
The start time of the call in the API user’s time zone, formatted in Soap XML. |
dimension |
total duration |
total duration |
The total duration of the call in seconds, including any time spent in an IVR. |
metric |
transaction id |
transaction id |
A globally unique identifier for the transaction, serving as the primary key. |
dimension |
transaction_id |
Transaction ID |
A globally unique identifier for the transaction, serving as the primary key. |
dimension |
transaction_type |
Type |
The classification of the transaction, such as Call, Post Call Event, Reported Conversion, or Signal. |
dimension |
transfer_from_type |
Transfer Type |
Describes the origin or source from which the call was transferred. |
dimension |
type |
type |
The classification of the transaction, such as Call, Post Call Event, Reported Conversion, or Signal. |
dimension |
verified_zip |
Verified Zip Code |
The zip code entered by callers when prompted during call treatment. |
dimension |
virtual_line_id |
Promo Number ID |
The identifier for the promotional number from the network. |
metric |