Invoca: Most-used fields

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