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.
스트라이프
조기 액세스
이 기능은 Early Access 버전입니다. 다음 기간동안 기능의 일부 측면은 여전히 개발 중일 수 있으며 이 문서가 항상 최신 상태인 것은 아닐 수도 있습니다. 질문이 있으시면 다음으로 문의하십시오: Amplitude Support.
이 연동은 Stripe의 수익 이벤트를 Amplitude로 가져오므로 Amplitude에서 Stripe 재무 데이터를 추적하고 분석할 수 있습니다.
Amplitude는 이러한 연동을 유지합니다. 도움이 필요하면 Amplitude 서포트에 문의하십시오.
사전 조건
- Amplitude 프로젝트가 여러 개 있는 경우 정확한 이벤트 트래킹을 보장하기 위해 각 프로젝트에 대해 이 연동을 개별적으로 구성하십시오.
- Stripe 이벤트 페이로드에 계정 식별자가 포함되어 있지 않으므로 Amplitude는 다른 계정 대상 구간의 Stripe 이벤트를 구별할 수 없습니다. 여러 개의 Stripe 계정을 동일한 Amplitude 프로젝트에 연결하면 데이터 중복과 부정확한 수익 보고가 발생할 수 있습니다.
- 이 연동은 Stripe 웹후크를 구성한 후 발생하는 이벤트만 기록합니다. 이는 그 이전에 발생한 모든 것을 소급적으로 캡처하거나 Amplitude로 전송하지 않으므로 가능한 빨리 설정하세요.
- 수익 데이터를 Amplitude로 전송하기 전에 모든 금융 금액을 선호하는 통화로 정규화하십시오. Amplitude는 통화 전환을 자동으로 처리하지 않으며, 일관성 없는 통화 보고는 수익 인사이트를 왜곡시킬 수 있습니다.
- 이 연동은 수익과 관련된 트랜잭션 이벤트만 수집합니다.
- 추적의 부정확성을 방지하려면 메타데이터에서
amplitude_id또는user_id을(를) 올바르게 설정하십시오. 그렇지 않으면 동일한 사용자의 이벤트가 Amplitude에서 별도의 사용자로 나타날 수 있습니다. 올바른 이벤트 중복 제거를 위해 메타데이터 필드 첫 사용 후 올바른 사용자 식별자를 전달하도록 Stripe 클라이언트를 업데이트하십시오.
연동 설정
- Stripe 계정에 로그인하고 _개발자 > 이벤트 목적지_로 이동합니다.
- 엔드포인트 추가를 클릭하여 웹후크를 생성하세요.
- 제공된 URL을 Endpoint URL 필드에 붙여넣어 데이터를 Amplitude 프로젝트로 전송합니다.
- API 버전 2024-06-20을 선택하고 Amplitude에 수집할 이벤트를 선택합니다.
- 이벤트 선택을 클릭하여 Amplitude로 전달할 주제를 지정합니다. Amplitude는
payment_intent을(를) 수익 이벤트로 분류한다는 점에 유의하십시오. - Stripe 클라이언트 코드에 올바른 사용자 ID를 설정하여 Stripe와 Amplitude 대상 구간 사용자 이벤트가 적절하게 중복 제거되도록 하십시오. 연동은 이벤트 페이로드에서 특정 우선 순위 순서로 사용자 ID를 검색합니다. 사용자 ID가 결제 의도 또는 기타 관련 이벤트에서 메타데이터로 올바르게 전달되었는지 확인하십시오.
다음은 Amplitude가 Stripe 이벤트 데이터에서 사용자 ID를 수집하는 순서입니다.
data.object.metadata.amplitude_iddata.object.metadata.user_iddata.object.customer_emaildata.object.customer.emaildata.object.receipt_emaildata.object.customer
Amplitude에서 Stripe 이벤트 보기: 예제 차트 및 코호트
다음은 연동 설정 후 추적할 수 있는 몇 가지 주요 차트와 지표입니다.
총 수익.
- 이벤트 선택: 성공적인 지불 또는 거래를 추적하는 이벤트를 선택합니다(예:
[Stripe] invoice.payment_succeeded). - 지표 설정: _Property Sum_을 사용하여 총 수익을 계산합니다. 이 속성을
amount_paid또는 수익 금액을 저장하는 다른 속성으로 설정합니다. 이는 성공적인 모든 결제 이벤트의 총 수익을 합산한 값입니다. - 세그멘테이션 적용: 위의 1단계에서 이벤트를 트리거한 모든 사용자가 생성한 총 수익에 대한 요약을 보려면 _모든 사용자_를 선택합니다.
사용자당 평균 구매 횟수
- 이벤트 선택:
self-serve: stripe payment intent success,Purchase Completed또는Order Success과 같이 성공적인 거래 또는 구매를 나타내는 이벤트를 선택합니다. - 지표 설정: 사용자당 평균 이벤트 수를 측정하여 사용자가 이벤트를 트리거하는 빈도를 추적합니다.
- 세그멘테이션 적용: 해당 이벤트와 관련된 모든 사용자 활동의 요약을 보려면 _모든 사용자_를 선택합니다.
구매 빈도 분포
- 이벤트 선택: 성공적인 결제 또는 구매를 추적하는 이벤트를 선택합니다(예:
[Stripe] invoice.payment_succeeded). - 지표 설정: _빈도_를 선택하여 사용자가 선택한 이벤트를 트리거한 횟수를 측정합니다.
- 버켓 설정: 구매 빈도를 범주화하기 위해 버켓을 정의합니다. 이를 통해 각 빈도 범주에 속하는 사용자의 수를 시각화할 수 있습니다.
- 세그멘테이션 적용: 사용자가 구매하는 빈도에 대한 요약을 보려면 _모든 사용자_를 선택합니다.
N주 리텐션
- 시작 이벤트 선택: 성공적인 거래 또는 구매를 나타내는 이벤트를 선택합니다(예:
[Stripe] invoice.payment_succeeded). - 재방문 이벤트 선택: 동일한 이벤트 또는 유사한 이벤트를 선택하여 다시 구매를 위해 돌아온 사용자를 추적하세요.
- 리텐션 지표 설정: 사용자가 특정 시간 기간(예: 주)에 다시 돌아와 동일한 이벤트를 트리거한 시점을 기준으로 리텐션을 측정하려면 해당일 복귀를 선택합니다. 이 차트는 여러 주(0주, 1주 등)에 걸친 리텐션을 표시하며, 그 후 몇 주 동안 구매를 한 후 재방문한 사용자 수를 보여줍니다.
- 세그멘테이션 적용: 구매를 한 후 다시 방문한 모든 사용자의 요약을 보려면 _모든 사용자_를 선택합니다.
제품별 매출
- 이벤트 선택: 성공적인 거래 또는 지급을 나타내는 이벤트를 선택합니다(예:
[Stripe] invoice.payment_succeeded). - 지표 설정: _Property Sum_을 사용하여 총 수익을 계산합니다. 제품 세부 정보를 저장하는 설명 필드(또는 이와 유사한 필드)를 사용하여 제품 범주나 이름별로 속성을 만듭니다. 이 값은 각 제품의 총 수익을 합산한 값입니다.
- 제품 속성별: 결과를 제품 이름이나 범주별로 그룹화하여 제품별 매출을 시각화합니다.
- 세그멘테이션 적용: 판매된 모든 제품의 수익 분석을 보려면 _모든 사용자_를 선택합니다.
제품별 주문 수
- 이벤트 선택: 성공적인 트랜잭션 또는 주문을 나타내는 이벤트를 선택합니다(예:
[Stripe] invoice.payment_succeeded). - 지표 설정: 고유 사용자를 사용하여 이벤트의 고유 발생을 계산합니다.
- 제품 속성별: 설명 필드(또는 이와 유사한 제품 관련 필드)를 사용하여 제품 이름이나 설명별로 데이터를 그룹화합니다. 이 정보는 제품당 주문 수를 분석합니다.
- 세그멘테이션 적용: 모든 사용자가 수행한 각 제품의 주문 건수를 요약해서 확인하려면 _모든 사용자_를 선택합니다.
코호트: 처음 7일 동안 100달러 이상을 지출한 사용자
- 이벤트를 수행한 사용자 선택: 성공적인 트랜잭션을 캡처하는 이벤트를 선택합니다(예:
[Stripe] payment_intent.succeeded). - 수익 조건 설정: 단일 거래 또는 여러 거래에서 100달러 이상을 지출한 사용자를 필터링할 조건을 적용합니다.
$revenue > 100 - 수행 회수가 조건 설정: 이벤트가 적어도 한 번 발생했는지 확인하는 조건을 추가하십시오.
- 시간 범위 정의: 트랜잭션은 사용자의 첫 상호 작용 후 다음 기간동안인 첫 사용 후 7일 이내에 발생해야 하거나, 보다 유연한 추적을 위해 첫 사용 후 30일 이내에 발생해야 한다고 지정합니다.
Amplitude에서 지원되는 스트라이프 이벤트
이 표에는 Stripe에서 Amplitude로 전송된 수익 관련 이벤트가 나열되어 있습니다. 이러한 이벤트를 통해 청구, 환불, 송장 및 지불과 같은 금융 거래를 추적할 수 있습니다. 각 이벤트와 관련된 속성에 대한 자세한 내용은 공식 Stripe 이벤트 문서를 참조하십시오.
| 카테고리 | 스트라이프 이벤트 | 설명 |
|---|---|---|
| 요금 및 환불 | charge.succeeded | 결제가 성공적으로 이루어질 때 발생합니다. |
| 요금 및 환불 | charge.refunded | 부분 환불을 포함하여 결제가 환불될 때 발생합니다. |
| 요금 및 환불 | charge.captured | 이전에 캡처되지 않은 결제 금액이 캡처될 때 발생합니다. |
| 요금 및 환불 | charge.updated | 요금 설명이나 메타데이터가 업데이트될 때 또는 비동기 캡처될 때 발생합니다. |
| 요금 및 환불 | charge.failed | 결제 시도가 실패했을 때 발생합니다. |
| 청구서 | invoice.payment_succeeded | 송장 지불 시도가 성공할 때 발생합니다. |
| 청구서 | invoice.paid | 송장 결제 시도가 성공하거나 송장이 외부 결제로 표시된 경우 발생합니다. |
| 청구서 | invoice.finalized | 초안 송장이 완료되고 미결제 송장으로 업데이트될 때 발생합니다. |
| 청구서 | invoice.marked_uncollectible | 송장이 수금 불가능으로 표시된 경우 발생합니다. |
| 청구서 | invoice.payment_failed | 송장 지불 시도가 실패할 때 발생합니다. |
| 청구서 | invoice.voided | 송장이 무효화될 때 발생합니다. |
| 청구서 | invoice.sent | 송장 이메일이 전송될 때 발생합니다. |
| 청구서 | invoice.created | 새 송장이 생성될 때 발생합니다. 이 이벤트에 웹후크를 사용하는 방법과 웹후크가 어떤 영향을 미칠 수 있는지 알아보려면 구독과 함께 웹후크 사용을 참조하세요. |
| 지불 의도 | payment_intent.succeeded | PaymentIntent가 지불을 성공적으로 완료했을 때 발생합니다. 이 이벤트는 Amplitude의 특별한 $revenue 이벤트입니다. |
| 지불 의도 | payment_intent.canceled | PaymentIntent취소될 때 발생합니다. |
| 지불 의도 | payment_intent.payment_failed | PaymentIntent가 결제 방법이나 지급을 생성하려는 시도가 실패한 경우 발생합니다. |
| 지불 의도 | payment_intent.amount_capturable_updated | PaymentIntent에 수집할 자금이 있을 때 발생합니다. PaymentIntent속성을 확인하여 캡처할 수 있는 amount_capturable금액을 확인하십시오. 지정된 amount_to_capture금액까지의 PaymentIntent값으로 캡처할 수 있습니다. PaymentIntents 캡처에 대해 자세히 알아보십시오. |
| 체크아웃 세션 | checkout.session.completed | 체크 아웃 세션이 성공적으로 완료되었을 때 발생합니다. |
| 체크아웃 세션 | checkout.session.async_payment_succeeded | 지연 결제 수단을 사용한 PaymentIntent가 성공할 때 발생합니다. |
| 체크아웃 세션 | checkout.session.async_payment_failed | 지연 결제 수단을 사용한 PaymentIntent가 실패할 때 발생합니다. |
| 신청 수수료 | application_fee.created | 신청 수수료가 청구에 따라 생성될 때 발생합니다. |
| 신청 수수료 | application_fee.refunded | 결제 금액을 환불하거나 신청 수수료를 직접 환불하는 등 신청 수수료가 환불될 때 발생합니다. 여기에는 부분 환불도 포함됩니다. |
| 신청 수수료 | application_fee.refund.updated | 신청 수수료 환불이 업데이트될 때 발생합니다. |
| 잔액 | balance.available | Stripe 잔액이 업데이트되었을 때 발생합니다. 기본적으로 Stripe는 매일 귀하의 잔액에 있는 자금을 귀하의 은행 계정으로 자동 이체합니다. 이 이벤트는 음수 트랜잭션에 대해 트리거되지 않습니다. |
| Issuing | issusing_authorization.created | 인증이 생성될 때 발생합니다. |
| Issuing | issusing_transaction.created | 발행 트랜잭션이 생성될 때 발생합니다. |
이 내용이 도움이 되었나요?