App Center SDK에서 수집한 데이터

중요

Visual Studio App Center는 2025년 3월 31일에 사용 중지될 예정입니다. Visual Studio App Center가 완전히 사용 중지될 때까지 계속 사용할 수 있지만 마이그레이션을 고려할 수 있는 몇 가지 권장 대안이 있습니다.

지원 타임라인 및 대안에 대해 자세히 알아봅니다.

App Center SDK는 App Center 서비스에 데이터를 보냅니다. 전송되는 데이터는 사용되는 SDK/서비스, SDK 구성 방법 및 크래시 서비스의 경우 애플리케이션에서 처리하는 데이터에 따라 달라집니다. 일부 서비스를 사용하려면 서비스가 작동하려면 특정 데이터를 보내야 합니다. App Center로 전송된 모든 데이터는 중앙 수집 서비스를 통해 이동합니다.

일반 데이터

SDK에서 수집으로 요청 헤더를 통해 전송된 데이터

필수 데이터 – App-Secret, Install-ID

  • 애플리케이션 비밀(App-Secret) 애플리케이션을 식별하는 데 사용되는 고유 키입니다.

  • 설치 식별자(Install-ID) App Center SDK를 사용하여 앱을 설치할 때마다 고유한 새 설치 식별자가 생성됩니다. 이 ID는 고유 디바이스와 데이터를 구분하는 데 사용됩니다. App Center 서비스는 ID가 제대로 작동해야 합니다.

SDK에서 수집으로 요청 본문을 통해 전송된 데이터

필수 데이터 - sdkName, sdkVersion, osName, osVersion, 로캘, timeZoneOffset, appVersion, appBuild

  • 타임스탬프(타임스탬프) 로그 타임스탬프, 예: '2017-03-13T18:05:42Z'

  • 세션 식별자(sid) 분석 로그는 이 식별자를 지정하여 동일한 세션의 일부가 될 수 있습니다.

  • 사용자 식별자(userId) 로그를 사용자와 연결하기 위해 사용되는 선택적 문자열입니다.

  • SDK 이름(sdkName) SDK의 이름입니다. SDK 및 플랫폼의 이름(예: "appcenter.ios", "hockeysdk.android")으로 구성됩니다.

  • SDK 버전(sdkVersion) semver 형식의 SDK 버전(예: "1.2.0" 또는 "0.12.3-alpha.1")

  • SDK 래퍼 버전(wrapperSdkVersion) 셈버 형식의 래퍼 SDK 버전입니다. SDK가 기본 SDK를 래핑하면 래핑 SDK 버전이 이 필드에 캡처되고 기본 SDK 버전은 sdkVersion입니다. 예를 들어 Xamarin.Android는 네이티브 Android를 래핑합니다.

  • SDK 래퍼 이름(wrapperSdkName) 래퍼 SDK의 이름입니다. SDK 및 래퍼 플랫폼의 이름(예: "appcenter.xamarin", "hockeysdk.cordova")으로 구성됩니다.

  • 모델(모델) 디바이스 모델(예: iPad2,3)

  • OEM 이름(oemName) 디바이스 제조업체의 이름(예: HTC)

  • 운영 체제 이름(osName) OS 이름(예: iOS)

  • 운영 체제 버전(osVersion) OS 버전(예: 9.3.0)

  • 운영 체제 빌드 코드(osBuild) OS 빌드 코드(예: LMY47X)

  • 운영 체제 API 수준(osApiLevel) Android에서와 같이 적용 가능한 경우 API 수준(예: 15)

  • 언어 및 국가 코드(로캘) ISO 언어 및 국가 코드(예: en-US)

  • 표준 시간대 오프셋(timeZoneOffset) 일광 절약 시간을 포함하여 디바이스 표준 시간대에 대한 UTC의 오프셋(분)입니다.

  • 화면 크기(screenSize) 디바이스 화면의 크기(예: 640x480)입니다.

  • 애플리케이션 버전(appVersion) 일반적으로 주, 부 빌드의 애플리케이션 버전(예: 1.1.42)

  • Carrier 이름(carrierName) 셀 서비스 공급자의 이름입니다.

  • Carrier Country(carrierCountry) 셀 서비스 공급자의 국가입니다.

  • 애플리케이션 빌드(appBuild) 앱의 빌드 번호입니다. (예: 42)

  • 애플리케이션 네임스페이스(appNamespace) 개별 플랫폼에서 사용하는 항목에 따라 번들 식별자, 패키지 식별자 또는 네임스페이스(예: com.microsoft.example)

  • Live Update 릴리스 레이블(liveUpdateReleaseLabel) 디바이스에서 실행되는 라이브 업데이트 비콘을 통해 릴리스된 애플리케이션 코드 '버전'을 식별하는 데 사용되는 레이블입니다.

  • 라이브 업데이트 배포 키(liveUpdateDeploymentKey) 현재 애플리케이션 릴리스가 속한 환경의 식별자이며 배포 키는 프로덕션, 스테이징과 같은 환경에 매핑됩니다.

  • 라이브 업데이트 패키지 해시(liveUpdatePackageHash) LiveUpdate 비콘을 통해 디바이스에 배포된 모든 파일(ReactNative 또는 Cordova)의 해시입니다. 디바이스에서 릴리스 버전을 식별하거나 나중에 업데이트를 다운로드해야 하는 경우

  • 런타임 래퍼 버전(wrapperRuntimeVersion) 래퍼 기술 프레임워크의 버전(Xamarin 런타임 버전, ReactNative, Cordova 등). 이 버전이 Xamarin 또는 ReactNative 또는 기타를 참조하는지 확인하려면 래퍼dkname을 참조하세요.

  • 탈옥(탈옥) 디바이스가 탈옥되었는지 여부를 나타내는 플래그입니다.

분석

  • 참여 메트릭 참여는 사용자 및 세션 기간당 일일 세션을 측정합니다.

    • 사용자당 일일 세션: 사용자당 일일 평균 세션 수입니다.

    • 총 세션: 총 세션 수입니다.

    • 일별 평균 세션 수: 시간 범위에서 하루 평균 세션 수입니다.

    • 세션 기간: 몇 기간 간격 동안의 세션 수 분포입니다.

    • 평균 세션 길이: 선택한 시간 범위의 모든 세션 기간의 평균입니다.

  • 이벤트 메트릭 최대 20개의 속성으로 고유한 이벤트 메트릭을 추적하여 사용자와 앱 간의 상호 작용을 이해할 수 있습니다.

진단

  • 크래시 및 오류 로그 데이터 이 데이터에는 크래시와 관련된 프로세스, 스레드, 프레임의 ID 및 이름, 공통 데이터 섹션에 정의된 예외 유형 및 메시지 및 디바이스 데이터가 포함됩니다.

  • 크래시 첨부 파일 이러한 첨부 파일은 개발자가 선택적으로 크래시 보고서에 연결할 수 있는 이진 파일 또는 텍스트 파일입니다.

  • 사용자 지정 속성 이러한 사용자 지정 키 값 쌍은 필요에 따라 오류 보고서에 컨텍스트를 추가하도록 지정할 수 있습니다.

  • 크래시 및 오류 사용자 ID 이 고유 식별자는 필요에 따라 개발자가 특정 사용자의 ID를 크래시 보고서에 연결하도록 설정합니다.

  • 기호 파일 이러한 기호 파일은 개발자가 App Center에서 크래시를 심볼화하기 위해 제공합니다.

배포

  • 토큰 이 GUID는 배포 서비스로 전송되어 새 버전의 애플리케이션을 검사. 애플리케이션이 App Center를 사용하여 설치된 경우에만 GUID가 전송됩니다.