매출 추적

수익 이벤트는 price, quantity, currency, 및 revenue 필드를 사용하여 구매를 캡처합니다. 이 페이지에서는 iOS, Android, 브라우저 SDK 및 HTTP API를 사용하여 수익 이벤트를 계측하여 LTV (Lifetime Value) 차트에 표시하는 방법을 설명합니다.

수익 속성을 포함하는 수익 이벤트만 차트에 나타납니다. 이 차트에는 검증된 이벤트와 검증되지 않은 이벤트가 모두 포함됩니다. 수익 이벤트를 전송하려면 다음 문서를 참조하십시오.

iOS SDK
안드로이드 SDK
브라우저 SDK
HTTP API입니다. price, quantity, currency, 및 revenue 필드를 설정하여 이벤트를 수익 이벤트로 기록합니다.

Amplitude는 사용자가 Amplitude 수집 시스템을 통해 전송한 이벤트만 계산합니다. Amplitude는 계산된 이벤트를 개별적으로 계산하지 않습니다. Revenue (Verified)또는 Revenue (Unverified)과 같이 수익 이벤트에 연결된 추가 이벤트는 한도에 포함되지 않습니다.

수익 속성

Amplitude는 수익을 추적하기 위해 수익 속성을 필요로합니다.

직접 보내거나 $revenue을 보내십시오$price. 대부분의 경우 $quantity을 포함합니다.
Amplitude는 수식을 사용하여 수익을 계산합니다$price * $quantity. $quantity가 존재하지 않는 경우 Amplitude는 1을 사용합니다.

이름	유형	설명	기본값
$revenue	더블	사용자의 구매로 인한 총 수익입니다. 음수 값은 유효합니다. 수익 이벤트를 LTV (Lifetime Value) 차트에 표시하려면 반드시 `$revenue` 필드를 전송해야 합니다.	null
$price	더블	구입한 제품의 가격입니다. 음수 값은 유효합니다.	null
$productId	문자열	제품의 식별자입니다.	null
$quantity	정수입니다.	구매한 제품의 수량입니다. 지정되지 않은 경우 기본값은 1입니다.	1
$revenueType	문자열	세금, 환급금 또는 소득과 같은 수익 유형입니다.	null
$currency	문자열	구매한 품목의 통화입니다. 3자리 대문자인 ISO 4217 코드를 사용하십시오(예: USD 또는 EUR).	null
eventProperties	객체입니다.	수익 이벤트에 포함시킬 이벤트 속성의 객체입니다. 이벤트 세분화 차트에 포함된 이벤트 속성에 대해서만 세분화할 수 있습니다.	null

수익 이벤트를 기록할 때 Amplitude의 SDK 또는 서버 측을 사용하여 수익 속성을 명시적으로 전송해야 합니다.

앱 내 구매 이외의 구매 추적

앱 내 구매가 아닌 구매의 경우, 수익 데이터를 Amplitude로 전송하는 방법은 세 가지가 있습니다.

Amplitude의 SDK를 사용하여 logRevenueV2함수를 호출하세요. logRevenueV2이 함수는 Revenue이벤트를 생성합니다.
$revenue속성을 포함하는 경우 Amplitude의 SDK를 사용하여 logEvent함수를 호출하세요.
price, quantity또는 revenue 필드를 설정하여 Amplitude의 HTTP API를 사용하세요. 고유한 이벤트 이름을 추가하십시오(예: Purchase completed).

Amplitude는 앱 내 구매에 대해서만 검증된 수익 확인을 수행합니다.

앱 내 구매 추적(IAP)

IAP를 추적하려면 Amplitude의 SDK에서 logRevenueV2또는 logEvent ($revenue속성과 함께)를 사용하여 일반 수익 이벤트를 전송하는 것과 동일한 방법으로 수익 이벤트를 전송하십시오. IAP의 경우 영수증 데이터를 수익 이벤트와 함께 전달하여 구매를 검증할 수 있습니다.

매출 검증 활성화

수익 확인을 활성화하려면 iTunes Connect In App 구매 공유 비밀번호 또는 Google Play 라이선스 공개 키를 Amplitude Data의 프로젝트의 소스 섹션에 복사하십시오. 수익 확인을 원하는 각 Amplitude 프로젝트에 대한 키를 포함해야 합니다. 또한 수익 이벤트를 확인하기 위해 Amplitude에 영수증 데이터를 전달해야 합니다.

Amplitude는 SDK logRevenue 호출에서 세 가지 수익 이벤트 유형을 생성할 수 있습니다. SDK 수익 이벤트 유형은 HTTP API를 통해 서버측에 전송되는 수익 이벤트와는 별개입니다.

이벤트 유형	설명
`Revenue`	수익 확인 기능의 사용 여부와 관계없이, Amplitude는 수익 이벤트에 대해 로그`Revenue`를 기록합니다. `Revenue`이벤트는 `$revenue`속성을 채우지 않습니다. `Revenue (Verified)`이벤트와 `Revenue (Unverified)`이벤트는 `$revenue`속성을 채웁니다. SDK 수익 이벤트를 LTV (Lifetime Value) 차트에 포함하려면 수익 검증을 켜십시오. 수익 확인이 켜져 있고 사용자 활동 스트림에 `Revenue`만 표시되는 경우 수익 확인에 실패했습니다.
`Revenue (Verified)`	Amplitude는 합법적인 트랜잭션`Revenue (Verified)`에 대해 로그를 기록합니다. `Revenue`와 `Revenue (Verified)`의 카운트 차이는 불법 앱 구매 횟수입니다. 기본적으로 SDK에 기록된 수익 이벤트는 Amplitude 대시보드에 확인되지 않은 수익 이벤트로 표시됩니다. `Revenue (Verified)`이벤트를 생성하려면 수익 확인을 활성화하십시오.
`Revenue (Unverified)`	확인되지 않은 수익 이벤트가 반드시 확인에 실패한 것은 아닙니다. 확인되지 않은 이벤트는 이벤트가 HTTP API 또는 JavaScript SDK를 통해 발생했거나 프로젝트에 수익 확인 키가 포함되어 있지 않았기 때문에 Amplitude가 확인을 시도하지 않았음을 의미합니다. 수익 확인 기능이 꺼져 있으면, Amplitude는 모든 수익 이벤트에 대해 로그`Revenue (Unverified)`를 기록합니다.

인증은 모바일에서만 켜거나 끌 수 있습니다. 웹은 항상 Revenue및 Revenue (Unverified)를 추적합니다.

Amplitude는 검증에 실패하지 않은 수익을 표시합니다. 예를 들어 Amplitude SDK를 통해 모바일과 웹 수익 이벤트를 모두 전송하는 경우 두 가지 Revenue (Verified)모두Revenue (Unverified)를 볼 수 있습니다.

영수증 검증

Amplitude는 Apple 또는 Google의 영수증을 기반으로 앱 내 구매를 확인합니다.

불일치

앱 스토어 보고서와 Amplitude 대상 구간 불일치는 시간대 차이, 이벤트 생성 버그 또는 불법 복제로 인해 발생할 수 있습니다.

불일치가 사소하고 매일 일관된 경우, 가장 가능성있는 원인은 앱 스토어와 Amplitude 대상 구간 시간대 차이입니다. Amplitude는 UTC를 사용합니다. 앱 스토어가 다른 시간대를 사용하는 경우, 앱 스토어는 Amplitude와 다른 날짜에 구매 이벤트를 리포트할 수 있습니다. 데이터가 손실되지 않습니다.

주요 불일치는 단일 구매에 대해 스토어 구매 콜백이 여러 회 실행되는 것과 같은 클라이언트측 오류에서 발생할 수 있습니다. 매장 구매가 성공한 후에만 수익 이벤트를 호출하십시오. 다음 호출은 이벤트 속성과 수익 금액을 추적합니다.

plaintext

AmplitudeClient.getInstance().logEvent('IAP', {type='Sale Special'})

plaintext

AmplitudeClient.getInstance().logRevenueV2("com.company.productid", 1, 2.99)

불법 복제는 또한 중요한 불일치를 야기할 수 있습니다. 사용자는 앱 스토어를 우회하여 앱 스토어 보고서에 표시되지 않는 구매를 할 수 있습니다. 데이터에서 불법 복제 수익 이벤트를 제외하려면 Amplitude의 수익 확인 방법을 사용하십시오. 불법 복제로 인해 데이터가 심하게 왜곡되었다고 의심되는 경우 Amplitude 서포트에 문의하십시오.

개발자를 위한 고려 사항

수익 이벤트를 추적할 때 다음 사항을 검토하십시오.

이전 버전과의 호환성: 기존 logRevenue 방법은 여전히 작동하지만 사용되지 않습니다. 이전 방법으로 기록된 이벤트는 revenueType와 같은 필드를 누락하므로 Amplitude 플랫폼은 이러한 수익 이벤트에 대한 세그멘테이션을 제한합니다.
사용자의 로깅 거부 선택: 다음을 호출하여 지정된 사용자에 대한 setOptOut로깅을 해제할 수 있습니다.

plaintext

amplitude.getInstance().setOptOut(true);

옵트아웃이 활성화된 상태에서는 Amplitude는 이벤트를 저장하거나 서버로 전송하지 않습니다. 옵트아웃 설정은 페이지가 로드될 때에도 유지됩니다. 다음 호출을 통해 로깅을 다시 활성화할 수 있습니다.

plaintext

amplitude.getInstance().setOptOut(false);

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