콘솔로 이동

메시지 전송 이해

FCM은 메시지 전송에 관한 통계를 확인할 수 있는 도구를 제공합니다. FCM은 Firebase 콘솔에서 기본적으로 제공되는 전송 보고서 및 알림 유입경로 분석과 더불어 Google BigQuery에 대한 포괄적인 데이터 내보내기 기능을 제공합니다.

이 페이지의 다양한 통계 결과를 보고하는 경우 애널리틱스 데이터를 일괄 처리해야 하므로 최대 24시간 정도 지연될 수 있습니다.

메시지 전송 보고서

내가 보내는 메시지가 사용자에게 도달하는지 여부를 평가할 수 있습니다. Firebase Console의 보고서 탭에서는 알림 작성기 및 FCM API를 통해 전송된 메시지를 비롯하여 Android나 iOS FCM SDK에 전송된 메시지에 대해 다음과 같은 데이터를 확인할 수 있습니다.

  • 전송 — 데이터 메시지 또는 알림 메시지가 전송을 위해 대기열에 추가되었거나 전송을 위해 APN과 같은 제3자 서비스에 성공적으로 전달되었습니다. 자세한 내용은 메시지의 수명을 참조하세요.
  • 수신됨(Android 기기에만 제공) — 데이터 메시지 또는 알림 메시지가 앱에 수신되었습니다. 이 데이터는 수신한 Android 기기에 FCM SDK 18.0.1 이상이 설치된 경우에 제공됩니다.
  • 노출(Android 기기의 알림 메시지에만 제공) — 앱이 백그라운드 상태일 때 디스플레이 알림이 기기에 표시되었습니다.
  • 열림 — 사용자가 알림 메시지를 확인했습니다. 앱이 백그라운드 상태일 때 수신된 알림만 보고됩니다.

이 데이터는 알림 페이로드가 포함된 모든 메시지 및 라벨이 지정된 모든 데이터 메시지에 제공됩니다. 라벨을 자세히 알아보려면 메시지에 애널리틱스 라벨 추가를 참조하세요.

메시지 보고서를 확인할 때 표시되는 데이터의 기간은 CSV로 내보내기 옵션을 통해 설정할 수 있습니다. 또한 다음 기준으로 필터링할 수 있습니다.

  • 플랫폼(iOS 또는 Android)
  • 커스텀 애널리틱스 라벨

메시지에 애널리틱스 라벨 추가

라벨 지정 메시지는 라벨 또는 라벨 세트로 전송 통계를 필터링할 수 있으므로 커스텀 분석에 매우 유용합니다. 메시지 객체의 fcmOptions.analyticsLabel 필드나 플랫폼별 AndroidFcmOptions 또는 ApnsFcmOptions 필드를 설정하여 HTTP v1 API를 통해 전송된 모든 메시지에 라벨을 추가할 수 있습니다.

애널리틱스 라벨은 ^[a-zA-Z0-9-_.~%]{1,50}$ 형식의 텍스트 문자열입니다. 라벨에는 소문자, 대문자, 숫자, 다음 기호를 포함할 수 있습니다.

  • -
  • ~
  • %

최대 길이는 50자(영문 기준)입니다. 일일 최대 100개의 고유 라벨을 지정할 수 있으며 이 한도를 초과한 라벨이 있는 메시지는 보고되지 않습니다.

Firebase Console 메시지 보고서 탭에서 모든 기존 라벨 목록을 검색한 후 라벨 1개를 단독으로 사용하거나 라벨을 조합하여 표시되는 통계를 필터링할 수 있습니다.

알림 유입경로 분석

기본적으로 제공되는 알림 유입경로 분석은 Firebase Console에서 전송되는 특정 알림에 사용자가 응답하는 방식을 보여줍니다. 이 뷰에는 아래 카테고리에 해당되는 타겟팅한 iOS 및 Android 기기의 데이터가 포함됩니다.

  • 전송된 알림 — 메시지가 전송을 위해 대기열에 추가되었거나 전송을 위해 APN과 같은 제3자 서비스에 성공적으로 전달되었습니다. 타겟팅한 비활성 토큰 또는 비활성 등록으로 인해 통계가 실제보다 높게 나올 수 있습니다.
  • 알림 확인 — 사용자가 확인한 알림의 수입니다. 앱이 백그라운드 상태일 때 수신된 알림만 보고됩니다.
  • 전환 이벤트가 정의된 경우 전환 이벤트를 트리거한 순 사용자 수

알림 유입경로 분석을 확인하는 방법은 다음과 같습니다.

  1. 알림 작성기에서 알림 탭을 선택합니다.
  2. 메시지 목록에서 완료되었거나 진행 중인 메시지를 클릭합니다. 유입경로 분석이 포함된 보기가 펼쳐집니다.

애널리스틱스 보고서는 주기적으로 업데이트되지만 사용자가 알림을 여는 시점과 콘솔에 이벤트 데이터가 제공되는 시점 사이에 다소 지연이 발생할 수 있습니다. 알림 탭의 이러한 보고서 외에도 애널리틱스에서 맞춤 유입경로를 빌드하여 앱에서 각 단계의 순차적인 완료율을 시각적으로 확인할 수 있습니다.

BigQuery 데이터 내보내기

BigQuery로 메시지 데이터를 내보내서 추가 분석을 할 수 있습니다. BigQuery를 사용하면 BigQuery SQL로 데이터를 분석하여 다른 클라우드 제공업체로 내보내거나, 맞춤 ML 모델에 데이터를 사용할 수 있습니다. BigQuery로 내보내기에는 플랫폼, 메시지 유형 또는 메시지가 API나 알림 작성기를 통해 전송되는지 여부에 관계없이 모든 메시지가 포함됩니다.

자세한 내용은 Firebase를 BigQuery에 연결을 참조하세요.

  1. 다음 옵션 중 하나를 사용하여 시작합니다.

    • 알림 작성기를 열고 페이지 하단의 BigQuery 연결을 클릭합니다.

    • Firebase Console의 통합 페이지에서 BigQuery 카드에 있는 연결을 클릭합니다.

      이 페이지에는 프로젝트 내 모든 FCM 지원 앱의 FCM 내보내기 옵션이 표시됩니다.

  2. 화면의 안내에 따라 BigQuery를 사용 설정합니다.

프로젝트를 BiqQuery에 연결하면 Firebase는 다음과 같이 작동합니다.

BigQuery 내보내기를 중지하려면 Firebase Console에서 프로젝트를 연결 해제합니다.

어떤 유형의 데이터를 BigQuery로 내보내나요?

타겟팅한 비활성 토큰 또는 비활성 등록으로 인해 일부 통계가 실제보다 높게 나올 수 있습니다.

내보낸 테이블의 스키마는 다음과 같습니다.

_PARTITIONTIME 타임스탬프 이 유사 열에는 데이터가 로드된 하루의 시작(UTC)을 나타내는 타임스탬프가 포함되어 있습니다. YYYYMMDD 파티션의 경우 TIMESTAMP('YYYY-MM-DD') 값이 이 유사 열에 포함됩니다.
event_timestamp 타임스탬프 서버에서 기록된 이벤트 타임스탬프
project_number 정수 프로젝트 번호는 메시지를 보낸 프로젝트를 식별합니다.
message_id 문자열 메시지 ID는 단일 고유 메시지를 식별합니다.
instance_id 문자열 메시지가 전송된 앱의 인스턴스 ID(사용 가능한 경우)입니다.
message_type 문자열 메시지의 유형입니다. 알림 메시지 또는 데이터 메시지일 수 있습니다. 주제는 주제 또는 캠페인 전송의 원래 메시지를 식별하는 데 사용되며 후속 메시지는 알림 또는 데이터 메시지입니다.
sdk_platform 문자열 수신자 앱의 플랫폼입니다.
app_name 문자열 Android 앱의 패키지 이름 또는 iOS 앱의 번들 ID입니다.
collapse_key 문자열 축소 키는 축소할 수 있는 메시지 그룹을 식별합니다. 기기가 연결되어 있지 않으면 축소 키가 지정된 마지막 메시지만 최종 전달을 위해 대기열에 추가됩니다.
priority 정수 메시지의 우선순위입니다. 유효한 값은 'normal' 및 'high'입니다. iOS에서는 각각 APN 우선 순위 5와 10에 해당합니다.
ttl 정수 이 매개변수는 기기가 오프라인 상태인 경우 FCM 저장소에 메시지를 보관해야 하는 시간(초)을 지정합니다.
topic 문자열 메시지가 전송된 주제의 이름입니다(해당되는 경우).
bulk_id 정수 일괄 ID는 주제에 대한 특정 전송과 같은 관련 메시지의 그룹을 식별합니다.
device_recently_active 부울 기기가 최근에 연결된 경우 이 매개변수는 True입니다.
event 문자열 이벤트 유형입니다. 가능한 값은 다음과 같습니다.
  • MESSAGE_ACCEPTED: FCM 서버가 메시지를 수신했고 요청이 유효합니다.
  • MESSAGE_DELIVERED: 메시지가 기기에 전송되었습니다.
  • MESSAGE_DELIVERED_ON_RECONNECT: 기기를 다시 연결했을 때 메시지가 기기에 전송되었습니다.
  • MISSING_REGISTRATIONS: 누락된 등록으로 인해 요청이 거부되었습니다.
  • MESSAGE_EXPIRED: 기기가 연결되어 전달되기 전에 메시지가 만료되었습니다.
  • MESSAGE_DELAYED_DOZE: 기기가 잠자기 모드이므로 기기에 대한 메시지 전달이 지연되고 있습니다.
  • UNAUTHORIZED_REGISTRATION: 발신자에게 등록을 보낼 권한이 없으므로 메시지가 거부되었습니다.
  • MESSAGE_COLLAPSED: 메시지가 전달되기 전에 동일한 축소 키가 설정된 최신 메시지로 대체되었습니다.
  • MESSAGE_RECEIVED_INTERNAL_ERROR: 메시지 요청을 처리하는 동안 미지정 오류가 발생했습니다.
  • MESSAGE_DELAYED_THROTTLED: 축소 키의 제한으로 인해 기기에 대한 메시지 전달이 지연되었습니다.
  • MISMATCH_SENDER_ID: 메시지를 전송하는 발신자 ID와 엔드포인트를 선언한 발신자 ID가 일치하지 않아 메시지 전송 요청이 거부되었습니다.
  • QUOTA_EXCEEDED: 할당량 부족으로 인해 메시지 전송 요청이 거부되었습니다.
  • INVALID_REGISTRATION: 잘못된 등록으로 인해 메시지 전송 요청이 거부되었습니다.
  • INVALID_PACKAGE_NAME: 잘못된 패키지 이름으로 인해 메시지 전송 요청이 거부되었습니다.
  • INVALID_APNS_CREDENTIAL: 잘못된 APNS 인증서로 인해 메시지 전송 요청이 거부되었습니다.
  • INVALID_PARAMETERS: 잘못된 매개변수로 인해 메시지 전송 요청이 거부되었습니다.
  • PAYLOAD_TOO_LARGE: 한도보다 큰 페이로드로 인해 메시지 전송 요청이 거부되었습니다.
  • DEVICE_NOT_FOUND: 데이터베이스에서 기기를 찾을 수 없으므로 메시지 전송 요청이 거부되었습니다.
  • AUTHENTICATION_ERROR: 인증 오류로 인해 메시지 전송 요청이 거부되었습니다(메시지 전송에 사용된 API 키 확인).
  • INVALID_TTL: 잘못된 TTL로 인해 메시지 전송 요청이 거부되었습니다.

내보낸 데이터로 무엇을 할 수 있나요?

앱별로 전송한 메시지 수 집계

SELECT app_name, COUNT(1)
FROM [<project name>:firebase_messaging.data]
WHERE
  _PARTITIONTIME = TIMESTAMP('<date as YYYY-MM-DD>')
  AND event = 'MESSAGE_ACCEPTED'
  AND message_id != ''
GROUP BY 1;

메시지에서 대상으로 하는 고유 앱 인스턴스 수 집계

SELECT COUNT(DISTINCT instance_id)
FROM [<project name>:firebase_messaging.data]
WHERE
  _PARTITIONTIME = TIMESTAMP('<date as YYYY-MM-DD>')
  AND event = 'MESSAGE_ACCEPTED';

전송된 알림 메시지 수 집계

SELECT COUNT(1)
FROM [<project name>:firebase_messaging.data]
WHERE
  _PARTITIONTIME = TIMESTAMP('<date as YYYY-MM-DD>')
  AND event = 'MESSAGE_ACCEPTED'
  AND message_type = 'DISPLAY_NOTIFICATION';

전송된 데이터 메시지 수 집계

SELECT COUNT(1)
FROM [<project name>:firebase_messaging.data]
WHERE
  _PARTITIONTIME = TIMESTAMP('<date as YYYY-MM-DD>')
  AND event = 'MESSAGE_ACCEPTED'
  AND message_type = 'DATA_MESSAGE';

알림 콘솔에서 주제 또는 캠페인으로 전송된 메시지 수 집계

SELECT COUNT(1)
FROM [<project name>:firebase_messaging.data]
WHERE
  _PARTITIONTIME = TIMESTAMP('<date as YYYY-MM-DD>')
  AND event = 'MESSAGE_ACCEPTED'
  AND bulk_id = <your bulk id> AND message_id != '';

지정된 주제 또는 캠페인의 팬아웃 기간 계산

팬아웃 시작 시간은 원본 요청이 수신된 시간이고 종료 시간은 단일 인스턴스를 타겟팅하는 마지막 개별 메시지가 생성된 시간입니다.

SELECT
  TIMESTAMP_DIFF(
    end_timestamp, start_timestamp, MILLISECOND
  ) AS fanout_duration_ms,
  end_timestamp,
  start_timestamp
FROM (
    SELECT MAX(event_timestamp) AS end_timestamp
    FROM [<project name>:firebase_messaging.data]
    WHERE
      _PARTITIONTIME = TIMESTAMP('<date as YYYY-MM-DD>')
      AND event = 'MESSAGE_ACCEPTED'
      AND bulk_id = <your bulk id>
  ) sent
  CROSS JOIN (
    SELECT event_timestamp AS start_timestamp
    FROM [<project name>:firebase_messaging.data]
    WHERE
      _PARTITIONTIME = TIMESTAMP('<date as YYYY-MM-DD>')
      AND event = 'MESSAGE_ACCEPTED'
      AND bulk_id = <your bulk id>
      AND message_type = 'TOPIC'
  ) initial_message;

전달된 메시지 비율 집계

SELECT
  messages_sent,
  messages_delivered,
  messages_delivered / messages_sent * 100 AS percent_delivered
FROM (
    SELECT COUNT(DISTINCT CONCAT(message_id, instance_id)) AS messages_sent
    FROM [<project name>:firebase_messaging.data]
    WHERE
      _PARTITIONTIME = TIMESTAMP('<date as YYYY-MM-DD>')
      AND event = 'MESSAGE_ACCEPTED'
  ) sent
  CROSS JOIN (
    SELECT COUNT(DISTINCT CONCAT(message_id, instance_id)) AS messages_delivered
    FROM [<project name>:firebase_messaging.data]
    WHERE
      _PARTITIONTIME = TIMESTAMP('<date as YYYY-MM-DD>')
      AND (event = 'MESSAGE_DELIVERED' OR event = 'MESSAGE_DELIVERED_ON_RECONNECT')
      AND message_id
      IN (
        SELECT message_id FROM [<project name>:firebase_messaging.data]
        WHERE
          _PARTITIONTIME = TIMESTAMP('<date as YYYY-MM-DD>')
          AND event = 'MESSAGE_ACCEPTED'
        GROUP BY 1
      )
  ) delivered;

지정된 메시지 ID 및 인스턴스 ID의 모든 이벤트 추적

SELECT *
FROM [<project name>:firebase_messaging.data]
WHERE
    _PARTITIONTIME = TIMESTAMP('<date as YYYY-MM-DD>')
    AND message_id = '<your message id>'
    AND instance_id = '<your instance id>'
ORDER BY event_timestamp;

지정된 메시지 ID 및 인스턴스 ID의 지연 시간 계산

SELECT
  TIMESTAMP_DIFF(
    MAX(delivered_time), MIN(accepted_time), MILLISECOND
  ) AS latency_ms
FROM (
    SELECT event_timestamp AS accepted_time
    FROM [<project name>:firebase_messaging.data]
    WHERE
      _PARTITIONTIME = TIMESTAMP('<date as YYYY-MM-DD>')
      AND message_id = '<your message id>'
      AND instance_id = '<your instance id>'
      AND event = 'MESSAGE_ACCEPTED'
  ) sent
  CROSS JOIN (
    SELECT event_timestamp AS delivered_time
    FROM [<project name>:firebase_messaging.data]
    WHERE
      _PARTITIONTIME = TIMESTAMP('<date as YYYY-MM-DD>') AND
      message_id = '<your message id>' AND instance_id = '<your instance id>'
      AND (event = 'MESSAGE_DELIVERED' OR event = 'MESSAGE_DELIVERED_ON_RECONNECT')
  ) delivered;