전환 보내기
판매나 가입이 일어나면 서버가 방문과 함께 보냅니다. 환불 같은 경우 나중에 상태를 바꿀 수 있습니다.
호출
POST https://<your workspace address>/track/conversions
x-api-key: your API key
Content-Type: application/json
{
"hit": "h1.…",
"conversionTypeCode": "sale",
"externalId": "order-1042",
"amount": { "value": 49.90 },
"currency": "EUR"
}
| 항목 | |
|---|---|
hit |
hitctrl 쿠키(또는 서버 측 방문)의 서명된 방문. |
conversionTypeCode |
필수. 전환 유형의 코드(예: sale). |
externalId |
주문이나 거래 ID. 같은 ID는 한 번만 집계되므로 다시 보내도 안전합니다. |
amount.value, currency |
판매 금액. 비율 지급액에 필요합니다. 다른 통화는 그날의 환율로 바꿉니다. |
exchangeRate |
워크스페이스가 받는다면, 워크스페이스 통화로의 내 환율. |
couponCodes |
사용한 쿠폰 코드. 쿠폰의 파트너가 방문보다 먼저 판매를 얻습니다. |
externalClientId |
내가 등록한 고객. 판매는 그 고객 방문의 파트너에게 인정됩니다. |
country |
구매자의 국가(두 글자). 방문의 국가 대신 이 국가로 판매를 평가합니다. |
customParams.advS1–advS5 |
내 값. 지급 그룹과 부정 행위 규칙에서 쓸 수 있습니다. |
status |
approved, pending, test 중 하나. 빼면 오퍼 목표가 정한 상태가 됩니다. |
hit, couponCodes, externalClientId 중 하나는 필수입니다. 같은 값을 주소에 넣은 GET으로도 호출할 수 있습니다.
나중에 상태 바꾸기
POST https://<your workspace address>/track/conversions/status
{ "externalId": "order-1042", "status": "refunded" }
status는 approved, pending, rejected, refunded 중 하나입니다. 한 주문에 여러 유형의 전환이 있다면 conversionTypeCode를 넣으세요.
최대 부하
Prefer: respond-async 헤더를 보내면 바로 202가 돌아오고, 전환은 잠시 뒤에 기록됩니다.
질문에 대한 답이 되었나요?
2026년 10월 18일에 앱과 대조함