Simulation

예산 시뮬레이션 계산

매체별 예산 배분에 대한 예상 노출·클릭을 계산해 반환한다. 저장하지 않으므로 응답에 simulationId 가 없다. 로그인 없이 호출할 수 있다. 매체별로 단가가 가장 싼 상품을 대표로 삼으며, CTR 이 없는 상품은 카탈로그 전체 평균 CTR 로 클릭을 계산한다. 집행 가능 여부는 기간과 무관하게 배분 예산이 단가를 넘는지로만 판단한다. cpcWon 은 모든 매체를 클릭당 비용 하나로 통일해 보여주는 값으로, 클릭당 과금 매체는 단가 그대로이고 그 외 매체는 배분 예산 / 예상 클릭 수(중앙값)로 환산한다.

post/api/v1/simulations/estimate

Request

Base URL: https://api.chaeso-zip.com
URL: https://api.chaeso-zip.com/api/v1/simulations/estimate
Auth: none declared

Request body

totalBudgetWoninteger required

총 예산(원). 10만 이상 1,000만 이하

period'LE_1W' | 'W2_3' | 'M1' | 'M2_3' | 'GE_3M' required

집행 기간(온보딩과 같은 구간). 구간이라 계산에는 대표 일수를 쓴다 — LE_1W=1주 이하(7일), W2_3=2-3주(17일), M1=1개월(30일), M2_3=2-3개월(75일), GE_3M=3개월 이상(90일). 하루 예산을 계산할 때 프론트도 같은 일수를 써야 한다

Example request

{
  "totalBudgetWon": 3000000,
  "allocations": [
    {
      "budgetWon": 1000000,
      "allocationPct": 40
    }
  ]
}

Response

계산 성공

successboolean required

요청 성공 여부

codestring nullable required

성공 안내 코드. 안내할 것이 없으면 null

Example response

{
  "success": true,
  "data": {
    "totalBudgetWon": 3000000,
    "period": "M1",
    "totalEstImpressions": 1200000,
    "totalEstClicks": 24000,
    "executableChannelCount": 2,
    "items": [
      {
        "channelName": "11번가 광고",
        "iconUrl": "https://assets.chaeso-zip.com/channels/550e8400-e29b-41d4-a716-446655440000/icon.png",
        "allocatedBudgetWon": 1000000,
        "allocationPct": 40,
        "estImpressions": {
          "min": 170000,
          "max": 230000
        },
        "estClicks": {
          "min": 170000,
          "max": 230000
        },
        "minBudgetWon": 1000000,
        "shortfallWon": 500000
      }
    ]
  },
  "error": {
    "code": "C-001",
    "message": "입력값이 올바르지 않습니다.",
    "fieldErrors": [
      {
        "field": "name",
        "reason": "이름은 필수입니다."
      }
    ]
  },
  "code": "GOOGLE_ACCOUNT_LINKED"
}

Changes

No recorded changes to this operation across all 1 revision of this API.