| 오류 코드 | 원인 | 값 | 결과 |
|---|---|---|---|
| 2 | 이벤트 이름이 잘못되었습니다. 비어 있거나, 너무 길거나, 잘못된 문자가 포함되어 있습니다. | 잘못된 이벤트 이름 | 해당 이벤트는 무시되고 firebase_error 이벤트가 기록되며 firebase_error_value 파라미터는 잘못된 이벤트 이름을 표시합니다. |
| 3 | 이벤트 매개변수 이름이 잘못되었습니다. 비어 있거나, 너무 길거나, 잘못된 문자가 포함되어 있습니다. | 잘못된 매개변수 이름 | 이벤트 매개변수가 firebase_error 매개변수(이벤트당 하나)로 대체되고 firebase_error_value 매개변수가 추가되어 잘못된 매개변수 이름을 표시합니다. |
| 4 | 이벤트 파라미터 값이 너무 깁니다. | 잘못된 매개변수 이름 | 잘못된 파라미터가 삭제됩니다. 이벤트에 firebase_error 파라미터가 추가되고 firebase_error_value 파라미터가 추가되어 값이 잘못된 파라미터의 이름을 표시합니다. |
| 5 | 이벤트의 매개변수가 25개를 넘습니다. | 없음 | 초과한 이벤트 매개변수가 삭제됩니다. 이벤트에 firebase_error 파라미터가 추가되고 오류 코드의 값이 포함됩니다. |
| 6 | 사용자 속성 이름이 잘못되었습니다. 비어 있거나, 너무 길거나, 잘못된 문자가 포함되어 있습니다. | 잘못된 속성 이름 | 사용자 속성이 변경되지 않습니다. firebase_error 이벤트가 기록되고 firebase_error_value 파라미터는 잘못된 사용자 속성 이름을 표시합니다. |
| 7 | 사용자 속성 값이 너무 깁니다. | 잘못된 속성 이름 | 사용자 속성이 변경되지 않습니다. firebase_error 이벤트가 기록되고 파라미터의 값은 잘못된 사용자 속성 값의 이름을 표시합니다. |
| 8 | 앱 인스턴스가 기록하는 고유 이벤트 유형이 500개를 넘습니다. | 없음 | 초과한 이벤트가 삭제됩니다. firebase_error 이벤트가 기록되고 firebase_error 파라미터는 오류 코드를 표시합니다. |
| 9 | 앱 인스턴스가 설정하는 고유 사용자 속성이 25개를 넘습니다. | 없음 | 사용자 속성이 변경되지 않습니다. firebase_error 이벤트가 기록되고 firebase_error 파라미터는 오류 코드를 표시합니다. |
| 10 | 앱 인스턴스의 전환 이벤트 일일 한도를 초과하였습니다. | 없음 | 이벤트가 전환이 아닌 일반 이벤트로 기록됩니다. 이벤트에 firebase_error 파라미터가 추가되고 오류 코드의 값이 포함됩니다. |
| 11 | 앱 인스턴스가 블랙리스트에 포함된 이벤트를 기록했습니다. | 블랙리스트에 포함된 이벤트 이름 | 이벤트가 무시됩니다. firebase_error 이벤트가 기록되고 firebase_error_value 파라미터는 블랙리스트에 포함된 이벤트 이름을 표시합니다. |
| 12 | 앱 인스턴스가 블랙리스트에 포함된 사용자 속성을 설정했습니다. | 블랙리스트에 포함된 사용자 속성 이름 | 사용자 속성이 변경되지 않습니다. firebase_error 이벤트가 기록되고 firebase_error_value 파라미터는 블랙리스트에 포함된 사용자 속성을 표시합니다. |
| 13 | 예약된 이벤트 이름입니다. | 예약된 이벤트 이름 | 이벤트가 무시됩니다. firebase_error 이벤트가 기록되고 firebase_error_value 파라미터는 잘못된 이벤트 이름을 표시합니다. |
| 14 | 예약된 매개변수 이름입니다. | 예약된 매개변수 이름 | 이벤트 매개변수가 firebase_error 매개변수로 대체되고 오류 코드의 값이 포함됩니다. firebase_error_value 파라미터가 추가되어 예약된 파라미터 이름을 표시합니다. |
| 15 | 예약된 사용자 속성 이름입니다. | 예약된 사용자 속성 이름 | 사용자 속성이 변경되지 않습니다. firebase_error 이벤트가 기록되고 firebase_error_value 파라미터는 잘못된 사용자 속성 이름을 표시합니다. |
| 17 | 파라미터 배열 길이가 한도(200)를 초과했습니다. | 잘린 매개변수 배열 이름(값) | 배열 매개변수가 항목 200개로 잘립니다. 이벤트에 firebase_error 파라미터가(이벤트당 하나씩) 추가되고 오류 코드의 값이 포함됩니다. firebase_error_value 파라미터가 추가되어 잘린 파라미터의 이름을 표시합니다. |
| 18 | 값 매개변수 유형이 잘못되었습니다. | 잘못된 매개변수 이름(값) | 값 매개변수가 삭제됩니다. 이벤트에 firebase_error 파라미터가 추가되고 firebase_error_value 파라미터가 추가되어 유형(값)이 잘못된 파라미터의 이름을 표시합니다. |
| 19 | 전환 이벤트의 통화 파라미터가 누락되었습니다. | 잘못된 매개변수 이름(값) | 값 매개변수가 삭제됩니다. 이벤트에 firebase_error 매개변수가 추가되고 firebase_error_value 매개변수가 추가되어 매개변수(값)가 잘못된 매개변수의 이름을 표시합니다. |
| 20 | 이벤트 배열 매개변수 이름이 잘못되었습니다. | 잘못된 매개변수 이름(값) | 이벤트 매개변수가 firebase_error 매개변수(이벤트당 하나)로 대체되고 firebase_error_value 매개변수가 추가되어 잘못된 매개변수 이름을 표시합니다. |
| 21 | 이벤트가 배열 매개변수를 지원하지 않습니다. | 잘못된 이벤트 이름 | 이벤트 매개변수가 firebase_error 매개변수(이벤트당 하나)로 대체되고 firebase_error_value 매개변수가 추가되어 잘못된 이벤트 이름을 표시합니다. |
| 22 | 항목에 배열 기반 매개변수를 포함할 수 없습니다. | 잘못된 매개변수 이름(값) | 중첩된 배열 파라미터가 firebase_error 파라미터(파라미터당 하나)로 대체되고 firebase_error_value 파라미터가 추가되어 잘못된 파라미터 이름을 표시합니다. |
| 23 | 항목에 맞춤 매개변수를 포함할 수 없습니다. | 없음 | 맞춤 배열 매개변수는 삭제됩니다. 오류 코드 값을 가진 firebase_error 파라미터를 추가합니다. |
| 25 | 항목 배열이 Google Play 서비스의 클라이언트 버전에서 지원되지 않습니다(Android만 해당). | 없음 | 배열 매개변수가 삭제됩니다. 오류 코드 값을 가진 firebase_error 파라미터를 추가합니다. |
| 28 | 항목의 맞춤 매개변수가 27개를 초과합니다. | 없음 | 추가 항목 매개변수가 삭제됩니다. 항목에 firebase_error 파라미터가 추가되고 오류 코드의 값이 포함됩니다. |
애널리틱스 오류 코드
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-29(UTC)
[null,null,["최종 업데이트: 2025-08-29(UTC)"],[],[],null,["| Error Code | Cause | Value | Result |\n|------------|-------------------------------------------------------------------------------------|-------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 2 | Event name is invalid (empty, too long, invalid characters) | Name of the invalid event | The event is ignored and a firebase_error event is logged with a firebase_error_value parameter which indicates the invalid event name. |\n| 3 | Event parameter name is invalid (empty, too long, invalid characters) | Name of the invalid parameter | The event parameter is replaced with a firebase_error parameter (one per event) and a firebase_error_value parameter is added to indicate the invalid parameter name. |\n| 4 | Event parameter value is too long | Name of invalid parameter | The invalid parameter is dropped. A firebase_error parameter is added to the event and a firebase_error_value parameter is added to indicate the name of the parameter with the invalid value. |\n| 5 | Event has more than 25 parameters | None | Extra event parameters are dropped. A firebase_error parameter is added to the event with the value of the error code. |\n| 6 | User property name is invalid (empty, too long, invalid characters) | Name of invalid property. | The user property change is ignored. A firebase_error event is logged with a firebase_error_value parameter which indicates the invalid user property name. |\n| 7 | User property value is too long | Name of invalid property. | The user property change is ignored. A firebase_error event is logged with a parameter whose value indicates the name of the invalid user property value. |\n| 8 | App Instance logs more than 500 unique event types | None | Extra events are dropped. A firebase_error event is logged with a firebase_error parameter which indicates the error code. |\n| 9 | App Instance sets more than 25 unique user properties | None | The user property change is ignored. A firebase_error event is logged with a firebase_error parameter which indicates the error code. |\n| 10 | App Instance exceeds conversion event limit in a single day | None | Event is logged as a normal (i.e. non-conversion) event. A firebase_error parameter is added to the event with the value of the error code. |\n| 11 | App Instance logs blacklisted event | Name of blacklisted event | Event is ignored. A firebase_error event is logged with a firebase_error_value parameter which indicates the blacklisted event name. |\n| 12 | App Instance sets blacklisted user property. | Name of blacklisted user property. | The user property change is ignored. A firebase_error event is logged with a firebase_error_value parameter which indicates the blacklisted user property. |\n| 13 | Event name is reserved | Name of reserved event. | Event is ignored. A firebase_error event is logged with a firebase_error_value parameter which indicates the invalid event name. |\n| 14 | Event parameter name is reserved. | Name of reserved parameter. | Event parameter is replaced with a firebase_error parameter with the value of the error code. A firebase_error_value parameter is added to indicate the reserved parameter name. |\n| 15 | User property name is reserved | Name of reserved user property | The user property change is ignored. A firebase error event is logged with a firebase_error_value parameter which indicates the invalid user property name. |\n| 17 | Parameter array length exceeds limit (200) | Name of truncated parameter array (value) | The array parameter is truncated to 200 items. A firebase_error parameter is added to the event (one per event) with the value of the error code. A firebase_error_value parameter is added to indicate the name of the truncated parameter. |\n| 18 | Invalid value parameter type | Name of invalid parameter (value) | The value parameter is dropped. A firebase_error parameter is added to the event and a firebase_error_value parameter is added to indicate the name of the parameter with the invalid type (value). |\n| 19 | Missing currency parameter on a conversion event | Name of invalid parameter (value) | The value parameter is dropped. A firebase_error parameter is added to the event and a firebase_error_value parameter is added to indicate the name of the invalid parameter (value). |\n| 20 | Event array parameter name is invalid | Name of invalid parameter (value) | The event parameter is replaced with a firebase_error parameter (one per event) and a firebase_error_value parameter is added to indicate the invalid parameter name. |\n| 21 | Event does not support array parameters | Name of the invalid event | The event parameter is replaced with a firebase_error parameter (one per event) and a firebase_error_value parameter is added to indicate the invalid event name. |\n| 22 | Item cannot contain an array-based parameter | Name of invalid parameter (value) | The nested array parameter is replaced with a firebase_error parameter (one per param) and a firebase_error_value parameter is added to indicate the invalid param name. |\n| 23 | Item cannot contain custom parameters | None | Custom array parameters are dropped. Add a firebase_error parameter with the value of the error code. |\n| 25 | Item array not supported on client's version of Google Play Services (Android Only) | None | Array parameters are dropped. Add a firebase_error parameter with the value of the error code. |\n| 28 | Item has more than 27 custom parameters | None | Extra item parameters are dropped. A firebase_error parameter is added to the item with the value of the error code. |"]]