프로덕션을 위해 Amplitude 구현 준비

Amplitude 구현을 프로덕션에 릴리즈하기 전에 나중에 변경하기 어려운 세 가지 결정을 내려야 합니다. 즉, 데이터를 전송할 프로젝트 수, 사용자 동의 처리 방법, 프록시를 통해 브라우저 이벤트를 라우팅할지 여부입니다. 각 섹션은 하나의 결정에 대해 설명하며 전체 가이드로 연결됩니다.

하나의 프로젝트를 사용할지 플랫폼별로 사용할지 결정합니다.

크로스 플랫폼 계측은 모든 플랫폼(웹, iOS, Android)의 이벤트를 하나의 프로젝트로 전송합니다. 플랫폼 간 사용자 교차 사용이 자주 발생할 것으로 예상되거나 플랫폼 전반에서 행동을 분석하고자 할 때 유용하며, 이를 위해서는 사용자 ID를 수집해야 합니다. 모든 플랫폼에 걸친 합계를 하나의 뷰에서 확인할 수 있으며, 플랫폼을 아우르는 퍼널 또는 리텐션 차트를 확인할 수 있습니다.

별도의 플랫폼 계측은 각 플랫폼을 자체 프로젝트로 전송합니다. 앱이 각 플랫폼에서 독립형 앱으로 작동하며 교차 분석이 중요하지 않은 경우 이는 의미가 있습니다.

각 접근 방식의 장단점에 대해서는 교차 플랫폼 계측과 별도 플랫폼 계측을 참조하십시오.

쿠키 및 동의 관리 설정

제품이 데이터를 추적하기 전에 사용자 동의를 필요로 하는 경우, 릴리즈 전에 브라우저 SDK의 쿠키, 스토리지, 옵트인 또는 옵트아웃 동작을 구성하십시오. 프랑스의 CNIL 규정을 포함하여 Browser SDK 2 설정의 경우 쿠키 및 동의 관리로 이동하십시오.

프록시를 사용하여 광고 차단기로 인해 손실되는 이벤트 줄이기

사용자 브라우저의 광고 차단기는 Amplitude 이벤트를 삭제할 수 있습니다. Amplitude는 이를 방지하기 위해 프록시 서버를 사용할 것을 권장합니다. 프록시는 Amplitude로 전달하기 전에 your.domain.com/amplitude와 같은 자체 도메인을 통해 이벤트를 중계합니다.

프록시를 배포한 후에는 Browser SDK에서 serverUrl를 사용하여 프록시를 지정합니다. SDK가 Amplitude의 기본 엔드포인트에 대해서만 자동으로 압축을 활성화하므로 enableRequestBodyCompression을(를) true(으)로 설정하십시오.

ts
amplitude.init(API_KEY, {
  serverUrl: "https://your-proxy.example.com/events",
  enableRequestBodyCompression: true,
});

프록시 서버는 gzip으로 압축된 요청 본문을 지원해야 하며 Content-Encoding: gzip 헤더를 처리할 수 있어야 합니다.

원격 구성 요청은 별도의 설정을 사용합니다. 또한 프록시하려면 다음을 설정합니다remoteConfig.serverUrl.

ts
amplitude.init(AMPLITUDE_API_KEY, {
  remoteConfig: {
    serverUrl: "https://your-proxy.example.com/config",
  },
});

프록시 서비스를 구축하려면 도메인 프록시를 사용하여 이벤트 릴레이로 이동하십시오.

이 내용이 도움이 되었나요?

For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.

이 페이지에서