个人资料
返回特定日期范围内更新的个人资料信息。
备注
最新的资源版本是profiles_v2. 资源 profiles 即将被删除。 Resource version profiles_v2 现在包含新的必需参数：date_since 和 date_until.
请求格式
获取 https://api.appmetrica.yandex.com/logs/v1/export/profiles_v2.{csv | json}
? application_id=<int>
& [date_since=<string>]
& [date_until=<string>]
& fields=<string>
& [date_dimension=<string>]
& [limit=<string>]
& [use_utf8_bom=<bool>]
& [<any field name>=<string>]
& [version=<string>]
& [update_timestamp=<string>]
& [skip_unavailable_shards=<bool>]
|
|
按应用在 AppMetrica 中的数字 ID 过滤。 |
|
|
日期范围的开始，格式为 |
|
|
日期范围的结束，格式为 |
|
|
用逗号分隔的字段列表，用于示例。 一个包含所有可用字段的列表（便于快速复制）： |
|
|
此参数定义计算日期范围的起点：
|
|
|
列表中项目数量的限制。 默认取最大值。 不保证请求之间的结果一致（结果排序可能存在差异）。 |
|
|
启用字节顺序标记使用的参数。 默认值为 |
|
|
按可用字段之一的值过滤。 仅支持相等检查操作。 |
|
|
个人资料版本。 |
|
|
个人资料更新的时间，格式为 Unix time。 |
|
|
用于提高数据可用性。 默认值为 |
响应格式
如果请求了所有可用的字段：
{
"data": [
{
"profile_id": "string",
"appmetrica_gender": "string",
"appmetrica_birth_date": "string",
"appmetrica_notifications_enabled": "boolean",
"appmetrica_name": "string",
"appmetrica_crashes": "integer",
"appmetrica_errors": "integer",
"appmetrica_first_session_date": "string",
"appmetrica_last_start_date": "string",
"appmetrica_push_opens": "integer",
"appmetrica_push_send_count": "integer",
"appmetrica_sdk_version": "integer",
"appmetrica_sessions": "integer",
"android_id": "string",
"appmetrica_device_id": "integer",
"city": "string",
"connection_type": "string",
"country_iso_code": "string",
"device_manufacturer": "string",
"device_model": "string",
"device_type": "string",
"google_aid": "string",
"ios_ifa": "string",
"ios_ifv": "string",
"mcc": "integer",
"mnc": "integer",
"operator_name": "string",
"os_name": "string",
"os_version": "string",
"windows_aid": "string",
"app_build_number": "integer",
"app_framework": "integer",
"app_package_name": "string",
"app_version_name": "string"
},
...
]
}
应用程序ID,ios_ifa,操作系统名称,...
1111,024AE7EB-4128-4237-9803-D24950323D4D,ios,...
1111,3A86D5E8-1985-4A23-B147-5A1C0CF8781E,ios,...
1111,,android
...
|
|
用户个人资料 ID。 |
|
|
性别。 |
|
|
年龄。 |
|
|
通知已启用。 |
|
|
名称。 |
|
|
崩溃次数。 |
|
|
错误次数。 |
|
|
第一次会话的日期。 |
|
|
应用最后一次启动的日期。 |
|
|
打开的推送通知数量。 |
|
|
已发送的推送通知数量。 |
|
|
AppMetrica SDK 的版本。 |
|
|
会话次数。 |
|
|
Android 设备 ID。 |
|
|
AppMetrica 服务检测到的唯一设备标识符。 在 Android 中来自 AppSetId，在 iOS 中来自 IFV。 |
|
|
城市名称（英文）。 |
|
|
连接类型。 可能的值： |
|
|
ISO 国家代码。 |
|
|
AppMetrica 服务检测到的设备制造商（例如，Apple 或 Samsung）。 |
|
|
AppMetrica 服务检测到的设备型号（例如，Galaxy S6）。 |
|
|
AppMetrica 服务检测到的设备类型。 可能的值： |
|
|
设备的 Google AID，格式为从设备接收的格式。 |
|
|
设备的 IFA，格式为从设备接收的格式。 |
|
|
应用的 IFV，格式为从设备接收的格式。 |
|
|
移动国家代码。 |
|
|
移动网络代码。 |
|
|
移动运营商名称。 |
|
|
用户设备上的操作系统： |
|
|
用户设备上的操作系统版本。 |
|
|
设备的 Windows AID，格式为从设备接收的格式。 |
|
|
应用构建号。 |
|
|
框架类型。 返回以下值之一：
|
|
|
Android 的包名，或 iOS 的 Bundle ID（例如，ru.yandex.metro）。 |
|
|
开发者指定的应用版本格式。 |
Example
请求：
curl -X GET \
'https://api.appmetrica.yandex.com/logs/v1/export/profiles_v2.json?application_id=1111&fields=profile_id,appmetrica_gender,appmetrica_birth_date,appmetrica_notifications_enabled,appmetrica_name,appmetrica_crashes,appmetrica_errors,appmetrica_first_session_date,appmetrica_last_start_date,appmetrica_push_opens,appmetrica_push_send_count,appmetrica_sdk_version,appmetrica_sessions,android_id,appmetrica_device_id,city,connection_type,country_iso_code,device_manufacturer,device_model,device_type,google_aid,ios_ifa,ios_ifv,mcc,mnc,operator_name,os_name,os_version,windows_aid,app_build_number,app_framework,app_package_name,app_version_name' \
-H 'Authorization: OAuth oauth_token'
响应：
{
"data": [
{
"profile_id": "test",
"appmetrica_gender": "M",
"appmetrica_birth_date": "30",
"appmetrica_notifications_enabled": "false",
"appmetrica_name": "John",
"appmetrica_crashes": "1",
"appmetrica_errors": "3",
"appmetrica_first_session_date": "yyyy-mm-dd",
"appmetrica_last_start_date": "yyyy-mm-dd",
"appmetrica_push_opens": "3",
"appmetrica_push_send_count": "8",
"appmetrica_sdk_version": "3001000",
"appmetrica_sessions": "15",
"android_id": "android_id__example",
"appmetrica_device_id": "123456789012345678",
"city": "Moscow",
"connection_type": "wifi",
"country_iso_code": "RU",
"device_manufacturer": "Apple",
"device_model": "iPhone X",
"device_type": "phone",
"google_aid": "google_aid__example",
"ios_ifa": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"ios_ifv": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"mcc": "250",
"mnc": "1",
"operator_name": "MTS RUS",
"os_name": "ios",
"os_version": "12.2",
"windows_aid": "windows_aid__example",
"app_build_number": "1",
"app_framework": "0",
"app_package_name": "ru.yandex.metro",
"app_version_name": "1.0"
}
]
}
如果您没有找到所需答案，可以通过反馈表单提交您的问题。 请尽可能详细地描述问题。 如果可能，请附上截图。