advertiser/stats/installs/find | TUNE Docs (Legacy)

Jump to: GET Response Notes | Related Models

The v2 Reporting API for accessing log-level data has been deprecated. Customers are required to change their code to use the new v3 logs and exports endpoints.

= Required Parameter

Name

Type

Description

api_key

String

Your API Key; accessible on your User Details page of your TMC account.

start_date

Datetime

The beginning datetime for the requested results.

end_date

Datetime

The end datetime for the requested results.

filter

Filter

Filter by fields and boolean operators against fields of the Installs model.Show Filterable Fields

The following fields from the model can be filtered on.

= Required Parameter

Name	Description
_id	ID
ad_network_id	Ad Network ID
advertiser_file_id	Advertiser File ID
advertiser_id	Advertiser ID
advertiser_opt_out	Advertiser Opt Out
advertiser_ref_id	Advertiser Ref ID
advertiser_sub_ad_id	Advertiser Sub Ad ID
advertiser_sub_adgroup_id	Advertiser Sub Adgroup ID
advertiser_sub_campaign_id	Advertiser Sub Campaign ID
advertiser_sub_keyword_id	Advertiser Sub Keyword ID
advertiser_sub_placement_id	Advertiser Sub Placement ID
advertiser_sub_publisher_id	Advertiser Sub Partner Id
advertiser_sub_site_id	Advertiser Sub Site ID
age	Age
agency_id	Agency ID
altitude	Altitude
app_name	App Name
app_version	App Version
attribute_sub1	Attribute Sub 1
attribute_sub2	Attribute Sub 2
attribute_sub3	Attribute Sub 3
attribute_sub4	Attribute Sub 4
attribute_sub5	Attribute Sub 5
campaign_ad_id	Campaign Ad ID
campaign_id	Campaign ID
campaign_payout_id	Campaign Payout ID
campaign_url_id	Campaign URL ID
city_code	City Code
click_gross_count	Click Gross Count
click_publishers_count	Click Partners Count
click_unique_count	Click Unique Count
country_id	Country ID
created	Created
currency_code	Currency Code
currency_rate	Currency Rate
debug_mode	Debug Mode
device_brand	Device Brand
device_carrier	Device Carrier
device_id	Device ID
device_id_md5	Device ID Md5
device_id_sha1	Device ID Sha1
device_id_sha256	Device ID Sha256
device_ip	Device IP
device_model	Device Model
device_type	Device Type
existing_user	Existing User
fb_user_id	Fb User ID
fraud_action	The action taken; possible values of ‘Do not Attribute’, ‘Attribute, mark as Suspicious and send postback with reason code’, and ‘Attribute, mark as Suspicious and send postback without reason code’.
fraud_reason_codes	The reason why the install was marked as suspicious; possible values of ‘CUSTOM’, ‘COUNTRY_CONFLICT’, ‘DEVICE_CONFLICT’, ‘IP_PROXY’, ‘CONVERSION_TIME’.
fraud_status	Whether or not the install is marked as suspicious; possible values of "suspicious" or "NULL".
gender	Gender
google_aid	Google Aid
google_aid_md5	Google Aid Md5
google_aid_sha1	Google Aid Sha1
google_aid_sha256	Google Aid Sha256
google_user_id	Google User ID
id	Log ID
impression_created	Impression Datetime
impression_gross_count	Impression Gross Count
impression_publishers_count	Impression Partners Count
impression_unique_count	Impression Unique Count
ios_ifa	iOS IFA
ios_ifa_md5	iOS IFA md5
ios_ifa_sha1	iOS IFA sha1
ios_ifa_sha256	iOS IFA sha256
ios_ifv	iOS IFV
ios_ifv_md5	iOS IFV md5
ios_ifv_sha1	iOS IFV sha1
ip	Click IP
is_view_through	Is View Through
language	Language
latitude	Latitude
longitude	Longitude
mac_address	Mac Address
mac_address_md5	Mac Address Md5
mac_address_sha1	Mac Address Sha1
mat_id	MAT ID
match_type	Match Type
metro_code	Metro Code
odin	ODIN
os_id	Device OS ID
os_id_md5	Device OS ID Md5
os_id_sha1	Device OS ID Sha1
os_id_sha256	Device OS ID Sha256
os_jailbroke	Device jailbroken; 1= Yes 0=No
os_version	Device OS Version
package_name	Package Name
payout	Payout Amount
postal_code	Postal Code
profit	Profit
publisher_adgroup_id	Partner Adgroup Id
publisher_adgroup_item_id	Partner Adgroup Item Id
publisher_click_id	Publisher Click ID
publisher_id	Partner Id
publisher_ref_id	Partner Ref Id
publisher_sub1	Partner Sub 1
publisher_sub2	Partner Sub 2
publisher_sub3	Partner Sub 3
publisher_sub4	Partner Sub 4
publisher_sub5	Partner Sub 5
publisher_sub_ad_id	Partner Sub Ad Id
publisher_sub_adgroup_id	Partner Sub Adgroup Id
publisher_sub_campaign_id	Partner Sub Campaign Id
publisher_sub_keyword_id	Partner Sub Keyword Id
publisher_sub_placement_id	Partner Sub Placement Id
publisher_sub_publisher_id	Partner Sub Partner Id
publisher_sub_site_id	Partner Sub Site Id
referral_source	Referral Source
referral_url	Conversion Referrer
region_id	Region ID
request_url	Request URL
revenue	Revenue
revenue_usd	Revenue Usd
sdk	SDK Platform
sdk_version	SDK Version
session_datetime	Click Datetime
session_ip	Click IP
site_event_id	Site Event ID
site_event_type	Conversion Type
site_id	Site ID
stat_click_id	Click ID
stat_impression_id	Impression ID
status	Status
status_code	Status Code
test_profile_id	Test Profile ID
tracking_id	Tracking ID
transaction_id	Transaction ID
twitter_user_id	Twitter User ID
unid	UNID
unique_partner	Unique Partner, 1= Yes 0= No
user_agent	User Agent
user_email	User Email
user_email_md5	User Email Md5
user_email_sha1	User Email Sha1
user_id	User ID
user_id_md5	User ID Md5
user_id_sha1	User ID Sha1
username	Username
username_md5	Username Md5
username_sha1	Username Sha1
windows_aid	Windows Aid
windows_aid_md5	Windows Aid Md5
windows_aid_sha1	Windows Aid Sha1
windows_aid_sha256	Windows Aid Sha256

Show Filterable Fields

fields

Array

List of fields from the Installs model desired in results. Defaults to display all fields.Show Supported Values

Any of the following values from the LogInstalls model are supported.

= Required Parameter

Name	Description
_id	ID
ad_network_id	Ad Network ID
advertiser_file_id	Advertiser File ID
advertiser_id	Advertiser ID
advertiser_opt_out	Advertiser Opt Out
advertiser_ref_id	Advertiser Ref ID
advertiser_sub_ad_id	Advertiser Sub Ad ID
advertiser_sub_adgroup_id	Advertiser Sub Adgroup ID
advertiser_sub_campaign_id	Advertiser Sub Campaign ID
advertiser_sub_keyword_id	Advertiser Sub Keyword ID
advertiser_sub_placement_id	Advertiser Sub Placement ID
advertiser_sub_publisher_id	Advertiser Sub Partner Id
advertiser_sub_site_id	Advertiser Sub Site ID
age	Age
agency_id	Agency ID
altitude	Altitude
app_name	App Name
app_version	App Version
attribute_sub1	Attribute Sub 1
attribute_sub2	Attribute Sub 2
attribute_sub3	Attribute Sub 3
attribute_sub4	Attribute Sub 4
attribute_sub5	Attribute Sub 5
campaign_ad_id	Campaign Ad ID
campaign_id	Campaign ID
campaign_payout_id	Campaign Payout ID
campaign_url_id	Campaign URL ID
city_code	City Code
click_gross_count	Click Gross Count
click_publishers_count	Click Partners Count
click_unique_count	Click Unique Count
country_id	Country ID
created	Created
currency_code	Currency Code
currency_rate	Currency Rate
debug_mode	Debug Mode
device_brand	Device Brand
device_carrier	Device Carrier
device_id	Device ID
device_id_md5	Device ID Md5
device_id_sha1	Device ID Sha1
device_id_sha256	Device ID Sha256
device_ip	Device IP
device_model	Device Model
device_type	Device Type
existing_user	Existing User
fb_user_id	Fb User ID
fraud_action	The action taken; possible values of ‘Do not Attribute’, ‘Attribute, mark as Suspicious and send postback with reason code’, and ‘Attribute, mark as Suspicious and send postback without reason code’.
fraud_reason_codes	The reason why the install was marked as suspicious; possible values of ‘CUSTOM’, ‘COUNTRY_CONFLICT’, ‘DEVICE_CONFLICT’, ‘IP_PROXY’, ‘CONVERSION_TIME’.
fraud_status	Whether or not the install is marked as suspicious; possible values of "suspicious" or "NULL".
gender	Gender
google_aid	Google Aid
google_aid_md5	Google Aid Md5
google_aid_sha1	Google Aid Sha1
google_aid_sha256	Google Aid Sha256
google_user_id	Google User ID
id	Log ID
impression_created	Impression Datetime
impression_gross_count	Impression Gross Count
impression_publishers_count	Impression Partners Count
impression_unique_count	Impression Unique Count
ios_ifa	iOS IFA
ios_ifa_md5	iOS IFA md5
ios_ifa_sha1	iOS IFA sha1
ios_ifa_sha256	iOS IFA sha256
ios_ifv	iOS IFV
ios_ifv_md5	iOS IFV md5
ios_ifv_sha1	iOS IFV sha1
ip	Click IP
is_view_through	Is View Through
language	Language
latitude	Latitude
longitude	Longitude
mac_address	Mac Address
mac_address_md5	Mac Address Md5
mac_address_sha1	Mac Address Sha1
mat_id	MAT ID
match_type	Match Type
metro_code	Metro Code
odin	ODIN
os_id	Device OS ID
os_id_md5	Device OS ID Md5
os_id_sha1	Device OS ID Sha1
os_id_sha256	Device OS ID Sha256
os_jailbroke	Device jailbroken; 1= Yes 0=No
os_version	Device OS Version
package_name	Package Name
payout	Payout Amount
postal_code	Postal Code
profit	Profit
publisher_adgroup_id	Partner Adgroup Id
publisher_adgroup_item_id	Partner Adgroup Item Id
publisher_click_id	Publisher Click ID
publisher_id	Partner Id
publisher_ref_id	Partner Ref Id
publisher_sub1	Partner Sub 1
publisher_sub2	Partner Sub 2
publisher_sub3	Partner Sub 3
publisher_sub4	Partner Sub 4
publisher_sub5	Partner Sub 5
publisher_sub_ad_id	Partner Sub Ad Id
publisher_sub_adgroup_id	Partner Sub Adgroup Id
publisher_sub_campaign_id	Partner Sub Campaign Id
publisher_sub_keyword_id	Partner Sub Keyword Id
publisher_sub_placement_id	Partner Sub Placement Id
publisher_sub_publisher_id	Partner Sub Partner Id
publisher_sub_site_id	Partner Sub Site Id
referral_source	Referral Source
referral_url	Conversion Referrer
region_id	Region ID
request_url	Request URL
revenue	Revenue
revenue_usd	Revenue Usd
sdk	SDK Platform
sdk_version	SDK Version
session_datetime	Click Datetime
session_ip	Click IP
site_event_id	Site Event ID
site_event_type	Conversion Type
site_id	Site ID
stat_click_id	Click ID
stat_impression_id	Impression ID
status	Status
status_code	Status Code
test_profile_id	Test Profile ID
tracking_id	Tracking ID
transaction_id	Transaction ID
twitter_user_id	Twitter User ID
unid	UNID
unique_partner	Unique Partner, 1= Yes 0= No
user_agent	User Agent
user_email	User Email
user_email_md5	User Email Md5
user_email_sha1	User Email Sha1
user_id	User ID
user_id_md5	User ID Md5
user_id_sha1	User ID Sha1
username	Username
username_md5	Username Md5
username_sha1	Username Sha1
windows_aid	Windows Aid
windows_aid_md5	Windows Aid Md5
windows_aid_sha1	Windows Aid Sha1
windows_aid_sha256	Windows Aid Sha256

Show Supported Values

limit

Integer

Limit the number of Installs items returned per request.

page

Integer

Pagination offset of the limited result set.

sort

Sort

Fields of Installs followed by the direction (asc or desc). Results can be sorted with multiple fields and directions.Show Sortable Fields

The following fields from the model can be sorted in either ascending (ASC) or descending (DESC) order.

= Required Parameter

Name	Description
_id	ID
ad_network_id	Ad Network ID
advertiser_file_id	Advertiser File ID
advertiser_id	Advertiser ID
advertiser_opt_out	Advertiser Opt Out
advertiser_ref_id	Advertiser Ref ID
advertiser_sub_ad_id	Advertiser Sub Ad ID
advertiser_sub_adgroup_id	Advertiser Sub Adgroup ID
advertiser_sub_campaign_id	Advertiser Sub Campaign ID
advertiser_sub_keyword_id	Advertiser Sub Keyword ID
advertiser_sub_placement_id	Advertiser Sub Placement ID
advertiser_sub_publisher_id	Advertiser Sub Partner Id
advertiser_sub_site_id	Advertiser Sub Site ID
age	Age
agency_id	Agency ID
altitude	Altitude
app_name	App Name
app_version	App Version
attribute_sub1	Attribute Sub 1
attribute_sub2	Attribute Sub 2
attribute_sub3	Attribute Sub 3
attribute_sub4	Attribute Sub 4
attribute_sub5	Attribute Sub 5
campaign_ad_id	Campaign Ad ID
campaign_id	Campaign ID
campaign_payout_id	Campaign Payout ID
campaign_url_id	Campaign URL ID
city_code	City Code
click_gross_count	Click Gross Count
click_publishers_count	Click Partners Count
click_unique_count	Click Unique Count
country_id	Country ID
created	Created
currency_code	Currency Code
currency_rate	Currency Rate
debug_mode	Debug Mode
device_brand	Device Brand
device_carrier	Device Carrier
device_id	Device ID
device_id_md5	Device ID Md5
device_id_sha1	Device ID Sha1
device_id_sha256	Device ID Sha256
device_ip	Device IP
device_model	Device Model
device_type	Device Type
existing_user	Existing User
fb_user_id	Fb User ID
fraud_action	The action taken; possible values of ‘Do not Attribute’, ‘Attribute, mark as Suspicious and send postback with reason code’, and ‘Attribute, mark as Suspicious and send postback without reason code’.
fraud_reason_codes	The reason why the install was marked as suspicious; possible values of ‘CUSTOM’, ‘COUNTRY_CONFLICT’, ‘DEVICE_CONFLICT’, ‘IP_PROXY’, ‘CONVERSION_TIME’.
fraud_status	Whether or not the install is marked as suspicious; possible values of "suspicious" or "NULL".
gender	Gender
google_aid	Google Aid
google_aid_md5	Google Aid Md5
google_aid_sha1	Google Aid Sha1
google_aid_sha256	Google Aid Sha256
google_user_id	Google User ID
id	Log ID
impression_created	Impression Datetime
impression_gross_count	Impression Gross Count
impression_publishers_count	Impression Partners Count
impression_unique_count	Impression Unique Count
ios_ifa	iOS IFA
ios_ifa_md5	iOS IFA md5
ios_ifa_sha1	iOS IFA sha1
ios_ifa_sha256	iOS IFA sha256
ios_ifv	iOS IFV
ios_ifv_md5	iOS IFV md5
ios_ifv_sha1	iOS IFV sha1
ip	Click IP
is_view_through	Is View Through
language	Language
latitude	Latitude
longitude	Longitude
mac_address	Mac Address
mac_address_md5	Mac Address Md5
mac_address_sha1	Mac Address Sha1
mat_id	MAT ID
match_type	Match Type
metro_code	Metro Code
odin	ODIN
os_id	Device OS ID
os_id_md5	Device OS ID Md5
os_id_sha1	Device OS ID Sha1
os_id_sha256	Device OS ID Sha256
os_jailbroke	Device jailbroken; 1= Yes 0=No
os_version	Device OS Version
package_name	Package Name
payout	Payout Amount
postal_code	Postal Code
profit	Profit
publisher_adgroup_id	Partner Adgroup Id
publisher_adgroup_item_id	Partner Adgroup Item Id
publisher_click_id	Publisher Click ID
publisher_id	Partner Id
publisher_ref_id	Partner Ref Id
publisher_sub1	Partner Sub 1
publisher_sub2	Partner Sub 2
publisher_sub3	Partner Sub 3
publisher_sub4	Partner Sub 4
publisher_sub5	Partner Sub 5
publisher_sub_ad_id	Partner Sub Ad Id
publisher_sub_adgroup_id	Partner Sub Adgroup Id
publisher_sub_campaign_id	Partner Sub Campaign Id
publisher_sub_keyword_id	Partner Sub Keyword Id
publisher_sub_placement_id	Partner Sub Placement Id
publisher_sub_publisher_id	Partner Sub Partner Id
publisher_sub_site_id	Partner Sub Site Id
referral_source	Referral Source
referral_url	Conversion Referrer
region_id	Region ID
request_url	Request URL
revenue	Revenue
revenue_usd	Revenue Usd
sdk	SDK Platform
sdk_version	SDK Version
session_datetime	Click Datetime
session_ip	Click IP
site_event_id	Site Event ID
site_event_type	Conversion Type
site_id	Site ID
stat_click_id	Click ID
stat_impression_id	Impression ID
status	Status
status_code	Status Code
test_profile_id	Test Profile ID
tracking_id	Tracking ID
transaction_id	Transaction ID
twitter_user_id	Twitter User ID
unid	UNID
unique_partner	Unique Partner, 1= Yes 0= No
user_agent	User Agent
user_email	User Email
user_email_md5	User Email Md5
user_email_sha1	User Email Sha1
user_id	User ID
user_id_md5	User ID Md5
user_id_sha1	User ID Sha1
username	Username
username_md5	Username Md5
username_sha1	Username Sha1
windows_aid	Windows Aid
windows_aid_md5	Windows Aid Md5
windows_aid_sha1	Windows Aid Sha1
windows_aid_sha256	Windows Aid Sha256

Show Sortable Fields

response_timezone

Timezone

Timezone in which result dates are conveyed; defaults to the timezone set in your account.

GET Response Notes

List of found 'install log' records that matched filter criteria.

Returns: array

Sites referenced as site
Publishers referenced as publisher
AdNetworks referenced as ad_network
PublisherSubPublishers referenced as publisher_sub_publisher
PublisherSubSites referenced as publisher_sub_site
PublisherSubCampaigns referenced as publisher_sub_campaign
PublisherSubAdgroups referenced as publisher_sub_adgroup
PublisherSubAds referenced as publisher_sub_ad
PublisherSubKeywords referenced as publisher_sub_keyword
PublisherSubPlacements referenced as publisher_sub_placement
AdvertiserSubPublishers referenced as advertiser_sub_publisher
AdvertiserSubSites referenced as advertiser_sub_site
AdvertiserSubCampaigns referenced as advertiser_sub_campaign
AdvertiserSubAdgroups referenced as advertiser_sub_adgroup
AdvertiserSubAds referenced as advertiser_sub_ad
AdvertiserSubKeywords referenced as advertiser_sub_keyword
AdvertiserSubPlacements referenced as advertiser_sub_placement
Campaigns referenced as campaign
CampaignUrls referenced as campaign_url
SiteEvents referenced as site_event
CampaignPayouts referenced as campaign_payout
Countries referenced as country
Regions referenced as region
LogClicks referenced as stat_click
TestProfiles referenced as test_profile
Agencies referenced as agency