Simulation

예산 시뮬레이션 결과 저장

계산 결과를 스냅샷으로 저장하고 simulationId 를 포함해 반환한다. 사용자당 저장 개수에 제한이 없으며, 저장된 결과는 수정되지 않는다.

post/api/v1/simulations

Request

Base URL: https://api.chaeso-zip.com
URL: https://api.chaeso-zip.com/api/v1/simulations
Auth: HTTP bearer

Request body

serviceNamestring required

광고할 서비스명

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

{
  "serviceName": "채소집",
  "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.