마케팅 성과 보고
marketing__growth_review__compute채널별 광고비와 고객이 입력한 매출, 신규 유료 고객 수로 마케팅 성과 보고를 계산합니다. channels 에는 채널 이름과 그 기간의 광고비를 넣습니다. 계산하는 지표는 ROAS(광고비 대비 매출)와 CAC(신규 유료 고객 1명당 광고비) 두 가지이고, goal 에 목표를 넣으면 목표 대비 실적을 함께 돌려줍니다. 매출이나 고객 수가 없거나 통화가 섞이면 그 지표는 값 대신 사유를 돌려주며 숫자를 지어내지 않습니다. 입력한 숫자로 계산만 합니다. 외부 기관이나 광고 계정을 부르지 않으며 로그인이나 연동이 필요 없습니다. 로그인한 호출이면 첫 요청 전에 request_idempotency_key 값을 만들어 저장하세요. 응답을 받지 못한 그 요청을 되찾을 때만 같은 인자와 함께 그 값을 다시 보내고, 새로 실행할 때는 새 값을 쓰세요. 이 값 없이 다시 부르면 새 요청이 됩니다. 계정 없이 맛보기로 부를 때는 이 선택 칸을 쓸 수 없습니다. 기관 업무에 따로 있는 idempotency_key 칸은 다른 칸이니 그대로 두세요. 호출마다 토큰 1소진 요청 처리 시 XBOSS 작업을 생성하고 처리 결과를 저장합니다. 기관 원본의 조회 여부와 별개로 이 호출은 순수 읽기 전용이 아닙니다. 기관 데이터 변경은 도구별 실행 내용과 기존 확인 절차를 따릅니다.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"report_period": "<report_period>",
"channels": "<channels>"
},
"name": "marketing__growth_review__compute"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| goal | No | 목표값. 넣은 항목만 목표 대비 실적을 돌려준다 | |
| channels | Yes | 채널별 광고비 목록. 빈 목록도 받는다 | |
| leads_actual | No | 보고 기간의 실제 리드 수(목표 대비 실적) | |
| report_period | Yes | 보고 기간. 끝 날짜는 포함하지 않는다 | |
| customer_revenue | No | 고객이 직접 넣는 매출. 기간과 통화가 보고와 다르면 매출 지표는 값 대신 사유를 돌려준다 | |
| new_paid_customers | No | 보고 기간의 신규 유료 고객 수(CAC 분모, 목표 대비 실적) | |
| request_idempotency_key | No | 로그인한 호출에서 응답을 못 받은 같은 요청을 되찾을 때 쓰는 선택 값입니다. 쓰는 법은 도구 설명에 있습니다. |