프록시 세션 리플레이 요청

SDK 네트워크 트래픽이 Amplitude에 도달하기 전에 자체 도메인을 통과해야 하는 경우 세션 리플레이 요청을 프록시 처리하십시오. 브라우저에서 브라우저 스크립트를 호스팅하는 것과 별도로 요청을 프록시할 수 있습니다. iOS 및 Android SDK는 리플레이 업로드를 위한 사용자 지정 URL을 지원합니다.

프록시 API 호출

SDK 네트워크 요청을 자체 서버를 통해 라우팅하여 해당 요청이 amplitude.com 엔드포인트로 직접 이동하지 않도록 하십시오. 프록시 서버는 요청을 수신하여 Amplitude의 기본 엔드포인트로 전달한 다음 Amplitude의 응답을 변경하지 않고 반환합니다.

프록시의 작동 방식

최소한의 프록시 구현은 다음과 같아야 합니다.

  1. 사용자 지정 URL에서 SDK의 요청을 수락합니다.
  2. 전체 요청 본문과 모든 헤더(Host 제외)를 해당 Amplitude 엔드포인트로 전달합니다.
  3. 상태 코드, 헤더, 본문을 포함하여 SDK에 대한 Amplitude의 응답을 변경되지 않은 상태로 반환합니다.

프록시는 투명해야 합니다. 요청 또는 응답 페이로드를 제거, 수정 또는 버퍼링하지 마십시오. SDK는 재시도를 처리하므로 프록시가 이를 처리할 필요가 없습니다.

서버 측에 API 키 보관

다운스트림 서비스에 대한 Authorization 헤더를 삽입해야 하는 경우, API 키를 클라이언트 측 코드에 하드코딩하는 대신 프록시에 헤더를 삽입하십시오. 서버 측에 헤더를 삽입하면 자격 증명이 브라우저에 표시되지 않습니다.

선택적 분석 SDK 프록시

분석 SDK는 별도의 수집 및 원격 구성 엔드포인트를 사용합니다. 구현에서 분석 이벤트도 캡처하는 경우 프록시 분석 SDK 요청으로 이동하십시오.

세션 리플레이: 브라우저(플러그인 및 독립형 SDK)

세션 리플레이는 캡처된 데이터를 전송하고 별도의 엔드포인트를 통해 원격 구성을 가져옵니다. 각 요청을 해당 지역의 해당 API 엔드포인트로 전달하십시오.

세션 리플레이 플러그인:

js
sessionReplayPlugin({
  trackServerUrl: 'https://replay.yourdomain.com/sessions/v2/track',
  configServerUrl: 'https://replay.yourdomain.com/config'
});

세션 리플레이 독립형 SDK:

js
sessionReplay.init('API_KEY', {
  trackServerUrl: 'https://replay.yourdomain.com/sessions/v2/track',
  configServerUrl: 'https://replay.yourdomain.com/config'
});

세션 리플레이: 모바일(iOS 및 Android)

iOS 및 Android SDK는 사용자 지정 서버 URL을 설정할 때 리플레이 업로드를 프록시로 전송합니다. SDK가 프록시의 전체 업로드 URL을 가리키도록 설정하고, 프록시가 쿼리 문자열, 헤더 및 본문을 변경하지 않은 상태로 각 요청을 https://api-sr.amplitude.com/sessions/v2/track(US) 또는 https://api-sr.eu.amplitude.com/sessions/v2/track(EU)로 전달하도록 하십시오. 사용자 지정 서버 URL은 serverZone을 재정의합니다.

모바일 SDK는 Amplitude에서 직접 원격 구성을 가져옵니다. 사용자 지정 원격 구성 URL을 아직 지원하지 않습니다.

iOS 플러그인:

swift
let config = AmplitudeSwiftSessionReplayPlugin.Config(
    sampleRate: 1.0,
    uploadConfig: UploadConfig(serverUrl: "https://replay.yourdomain.com/sessions/v2/track")
)
amplitude.add(plugin: AmplitudeSwiftSessionReplayPlugin(config: config))

Android 플러그인:

kotlin
val sessionReplayPlugin = SessionReplayPlugin(
    context = applicationContext,
    sampleRate = 1.0,
    serverUrl = "https://replay.yourdomain.com/sessions/v2/track"
)
amplitude.add(sessionReplayPlugin)

Android 미들웨어:

kotlin
val sessionReplayMiddleware = SessionReplayMiddleware.Builder(amplitude)
    .sampleRate(1.0)
    .serverUrl("https://replay.yourdomain.com/sessions/v2/track")
    .build()
amplitude.addEventMiddleware(sessionReplayMiddleware)

React Native 및 Flutter 세션 리플레이 SDK는 사용자 지정 프록시 URL을 지원하지 않습니다. 해당 serverZone 옵션은 Amplitude의 미국 또는 EU 데이터 센터를 선택하며, 요청은 Amplitude로 직접 전송됩니다.

콘텐츠 보안 정책(CSP)

앱이 콘텐츠 보안 정책을 설정한 경우 자체 호스팅 파일 및 프록시된 엔드포인트로 전환할 때 업데이트하십시오.

예제 CSP(완전 자체 호스팅):

text
Content-Security-Policy: script-src 'self' https://assets.yourdomain.com; connect-src 'self' https://analytics.yourdomain.com https://replay.yourdomain.com; worker-src 'self' blob:;

귀하의 프록시는 Amplitude의 미국 또는 EU 엔드포인트로의 라우팅을 처리하므로 CSP는 귀하의 고유 도메인만 참조하면 됩니다. 동일한 정책이 두 지역 모두에 적용됩니다.

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

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.

이 페이지에서