세그먼트에서 결제 이벤트를 추적하여 분석, 마케팅 자동화 및 고객 데이터 플랫폼을 강화하세요. 결제, 구독 및 고객 생애 주기 이벤트를 300개 이상의 하위 도구로 자동으로 전송합니다.
이 통합은 세그먼트 작업 공간의 세그먼트 쓰기 키가 필요합니다.
시작하기
웹훅 섹션 열기
Dodo Payments 대시보드에서 웹훅 → + 엔드포인트 추가로 이동하고 통합 드롭다운을 확장합니다. 세그먼트 선택
세그먼트 통합 카드를 선택합니다.
쓰기 키 입력
구성에서 세그먼트 쓰기 키를 제공합니다.
변환 구성
세그먼트의 Track API에 맞게 이벤트 형식을 지정하기 위해 변환 코드를 편집합니다.
테스트 및 생성
샘플 페이로드로 테스트하고 생성을 클릭하여 동기화를 활성화합니다.
완료!
🎉 이제 결제 이벤트가 세그먼트에서 추적되고 연결된 도구로 전송됩니다.
변환 코드 예제
결제 이벤트 추적
function handler(webhook) {
if (webhook.eventType === "payment.succeeded") {
const p = webhook.payload.data;
webhook.url = "https://api.segment.io/v1/track";
webhook.payload = {
userId: p.customer.customer_id,
event: "Payment Completed",
properties: {
amount: (p.total_amount / 100).toFixed(2),
currency: p.currency || "USD",
payment_method: p.payment_method || "unknown",
payment_id: p.payment_id,
customer_email: p.customer.email,
customer_name: p.customer.name
},
timestamp: webhook.payload.timestamp
};
}
return webhook;
}
구독 생애 주기 추적
function handler(webhook) {
const s = webhook.payload.data;
switch (webhook.eventType) {
case "subscription.active":
webhook.url = "https://api.segment.io/v1/track";
webhook.payload = {
userId: s.customer.customer_id,
event: "Subscription Started",
properties: {
subscription_id: s.subscription_id,
product_id: s.product_id,
amount: (s.recurring_pre_tax_amount / 100).toFixed(2),
frequency: s.payment_frequency_interval,
next_billing: s.next_billing_date,
customer_email: s.customer.email
},
timestamp: webhook.payload.timestamp
};
break;
case "subscription.cancelled":
webhook.url = "https://api.segment.io/v1/track";
webhook.payload = {
userId: s.customer.customer_id,
event: "Subscription Cancelled",
properties: {
subscription_id: s.subscription_id,
product_id: s.product_id,
cancelled_at: s.cancelled_at,
cancel_at_next_billing: s.cancel_at_next_billing_date,
customer_email: s.customer.email
},
timestamp: webhook.payload.timestamp
};
break;
}
return webhook;
}
고객 속성 식별
function handler(webhook) {
if (webhook.eventType === "payment.succeeded") {
const p = webhook.payload.data;
webhook.url = "https://api.segment.io/v1/identify";
webhook.payload = {
userId: p.customer.customer_id,
traits: {
email: p.customer.email,
name: p.customer.name,
total_spent: (p.total_amount / 100).toFixed(2),
payment_method: p.payment_method || "unknown",
last_payment_date: webhook.payload.timestamp,
customer_since: webhook.payload.timestamp
}
};
}
return webhook;
}
- 통합 전반에 걸쳐 일관된 이벤트 이름 사용
- 분석 및 세분화를 위한 관련 속성 포함
- 정확한 이벤트 추적을 위한 적절한 타임스탬프 설정
- 적절한 사용자 식별을 위해 customer ID를 userId로 사용
문제 해결
- 쓰기 키가 올바르고 활성화되어 있는지 확인
- 이벤트 이름이 세그먼트 명명 규칙을 따르는지 확인
- 사용자 식별을 위해 userId가 올바르게 설정되어 있는지 확인
- 세그먼트 API 속도 제한 검토
- JSON 구조가 세그먼트 API 형식과 일치하는지 검증
- 모든 필수 필드가 포함되어 있는지 확인
- 이벤트 이름이 객체가 아닌 문자열인지 확인
