문제 해결

이 가이드에서는 일반적인 구현 오류를 해결하기 위한 일반적인 문제 해결 단계를 간략히 설명합니다.

이벤트 없음

이벤트가 Google 애널리틱스에 표시되지 않는 경우, 알아봐야 할 몇 가지 일반적인 문제가 있습니다.

먼저 클라이언트를 선택합니다.

  • 올바른 api_secret을 사용하고 있나요?

    api_secret을 적합한 스트림에 사용하고 있는지 확인합니다. 여러 스트림에 측정 프로토콜을 설정하면, 스트림마다 자체 보안 비밀이 생성됩니다.

  • api_secret이 여전히 유효한가요?

    스팸을 방지하기 위해 api_secret을 취소할 수 있습니다. 사용 중인 api_secret이 아직 유효한지 확인하세요. 스트림에 접근할 수 있는 권한을 가진 다른 사용자가 실수로 접근 권한을 취소했을 수도 있습니다.

  • api_secret이 올바르게 복사되었나요?

    api_secret은 대소문자를 구분합니다. Google 애널리틱스 UI의 api_secret이 코드에서 사용 중인 것과 정확하게 동일한지 다시 한번 확인하세요.

  • advertising_id는 사용하지 마세요.

    advertising_id는 유효한 기기 식별자로 지원되지 않습니다. Firebase를 사용 중인 경우 app_instance_id를 사용하고, gtag.js를 사용 중인 경우에는 client_id를 사용하세요.

잘못된 ID

측정 프로토콜은 Firebase용 Google 애널리틱스 SDK 및 gtag.js의 ID를 지원하므로 올바른 ID를 사용해야 합니다. Firebase용 Google 애널리틱스 SDK와 gtag.js 중 무엇을 사용하는지에 따라 사용해야 하는 ID가 달라집니다. 아래에 어떤 ID를 사용해야 하는지 나와 있습니다.

Firebase용 Google 애널리틱스 SDK

Firebase용 Google 애널리틱스 SDK를 사용하는 경우 사용해야 하는 ID는 다음과 같습니다.

다음을 사용해서는 안 됩니다.

  • firebase_instance_id - 이 ID를 요청에 포함하면 안 됩니다. 이 ID는 앱의 특정 인스턴스를 식별하는 데 사용되지만, Firebase 전용입니다. FCM 메시지와 같은 작업에 사용됩니다.

gtag.js

gtag.js를 사용하는 경우 사용해야 하는 ID는 다음과 같습니다.

  • measurement_id - 요청의 쿼리 매개변수에 이 ID를 포함합니다. 이 ID로 데이터 스트림을 고유하게 식별할 수 있습니다. 웹사이트의 모든 사용자는 동일한 measurement_id를 갖습니다. Google 애널리틱스 UI에서 다음과 같이 이동하여 찾을 수 있습니다.
    관리 > 데이터 스트림 > 스트림 선택 > 측정 ID
  • client_id - 요청의 POST 본문에 이 ID를 포함합니다. 이 ID로 웹 클라이언트의 특정 사용자 인스턴스를 고유하게 식별할 수 있습니다. 이 값은 앱의 사용자마다 다릅니다. 이 값을 검색하는 방법은 예시를 참고하세요.

서버 측 태그 지정 이벤트 누락

측정 프로토콜 클라이언트가 있는 서버 측 태그 관리자 설치를 사용하면 측정 프로토콜 형식의 이벤트를 컨테이너로 전송할 수 있습니다. 그러면 컨테이너는 다른 모든 SGTM 이벤트와 동일한 메커니즘을 사용하여 이러한 이벤트를 Google 애널리틱스로 전송합니다.

측정 프로토콜의 모든 기능을 사용하려면 컨테이너 대신 측정 프로토콜에 이벤트를 직접 전송하세요.