어떤 API를 사용해야 합니까?

다음과 같은 경우 HTTP V2 API를 사용하십시오.

• 소용량 데이터 파티션을 신속하게 전송하려는 경우
• 가능한 한 실시간에 가깝게 데이터를 수집하려는 경우
• 데이터를 동적으로 조정할 수 있는 유연성을 필요로 하는 경우

HTTP V2 API는 서버에서 HTTP V2 엔드포인트로 직접 데이터를 전송합니다.

장점: Amplitude의 서버가 데이터를 수신한 후, 귀하의 인스턴스는 비교적 짧은 시간 내에 데이터를 표시합니다. 따라서 HTTP V2 API는 실시간 또는 라이브 스트리밍 데이터에 대한 선호되는 선택입니다. 또한 Amplitude는 HTTP V2로 전송된 이벤트를 수신한 순서대로 처리합니다(동일한 device_id의 경우). 분석 시 항상 중요한 것은 아니지만, 시간에 민감한 퍼널 분석과 같이 순서가 중요한 경우에는 매우 중요할 수 있습니다.

단점: Amplitude는 초당 30개의 이벤트를 초과하는 사용자와 기기에 대한 요청을 제한합니다(Amplitude는 이를 최근 시간 창의 평균으로 측정합니다). 제한을 초과하면 오류가 발생하며 해당 사용자나 장치에 대한 이벤트 전송을 30초 동안 일시 중지한 후 다시 시도해야 합니다. HTTP V2 API는 데이터 볼륨이 많거나 확장이 필요한 경우에는 적합하지 않은 선택입니다.

HTTP V2 API는 다음과 같은 경우에 가장 유용합니다.

• 실시간 데이터 작업
• 소량의 데이터 작업
• 분할된 데이터의 작은 청크 작업하기

다음과 같은 경우 배치 이벤트 업로드 API를 사용하십시오.

• 대량 데이터 수집 계획하기
• 다른 플랫폼을 사용하고 있으며 Amplitude로 데이터를 전송하려는 경우
• HTTP V2 쓰로틀링 제한에 도달하고 있음

배치 이벤트 업로드 API는 대량의 이벤트 데이터를 한 번에 업로드합니다.

스로틀링은 Amplitude로 데이터를 전송할 때 고려해야 할 가장 중요한 사항 중 하나입니다. 데이터 처리 파이프라인의 작동 방식 때문에 단일 기기 또는 사용자에 대해 대량의 이벤트를 처리하는 것은 어려울 수 있습니다. Amplitude는 단일 사용자 또는 기기(EPUS/EPDS)의 경우 초당 10개의 이벤트 비율을 높음으로, 초당 30개의 이벤트 비율은 스팸으로 간주합니다. 일반적으로 인간은 이러한 속도로 이벤트를 생성하지 않으므로 이러한 속도는 종종 계측 오류나 스팸 데이터를 나타냅니다.

합법적인 사용 사례는 여전히 대용량 업로드, 특히 일괄 업로드를 정당화합니다. 예를 들어 일부 고객은 추가 정보를 먼저 추가할 수 있도록 하루가 끝날 때까지 이벤트 데이터를 업로드하지 않습니다. 사용자가 그날 10,000개의 이벤트를 생성했는데 이를 모두 1분 안에 전송하려고 하면 평균 100개 이상의 EPUS가 발생하며, 이는 HTTP V2 API가 처리할 수 없는 수준입니다. 배치 이벤트 업로드 API는 이러한 버스트를 흡수합니다. 이는 훨씬 높은 제한을 갖고 있으며 데이터를 더 오래 버퍼링합니다.

배치 이벤트 업로드 API는 다음과 같은 경우에 가장 유용합니다.

• 다시 채우기(과거 데이터 세트를 한 번에 전송)
• 다른 시스템에서 데이터 마이그레이션
• 비실시간 워크로드 작업
• Amplitude에서 즉시 필요하지 않은 데이터 작업

HTTP V2 API 및 배치 이벤트 업로드 API만이 Amplitude에 데이터를 전송하는 유일한 방법은 아닙니다. Amplitude는 또한 다음과 같은 기능을 제공합니다.

• 웹사이트, 모바일 앱 및 데스크톱 애플리케이션이 데이터를 쉽게 전송할 수 있도록 해주는 다양한 SDK
• 외부 시스템에서 데이터를 가져오는 클라우드 스토리지 소스 통합 및 타사 앱 통합

간단히 말해서, HTTP V2는 실시간 워크로드에 가장 적합합니다. 배치는 일괄 처리를 위해 가장 적합합니다. SDK 및 소스 통합은 대부분의 다른 경우를 지원합니다.