시안 검사
광고 시안 파일이 고른 지면의 규격에 맞는지 봅니다. AI를 쓰지 않습니다. 파일도 결과도 저장하지 않습니다.
이 화면 설명
광고 시안 파일이 고른 지면의 규격에 맞는지 봅니다. AI를 쓰지 않습니다. 파일 머리 몇 바이트에서 형식·가로·세로·길이를 읽어, 그 지면을 등록할 때 채워 둔 규격 칸과 견줍니다. 파일도 결과도 저장하지 않습니다. 여기서 “시안”은 등록 칸에서 “소재”라고 부르는 것과 같은 것입니다(광고로 내보낼 그림·영상 파일).
1. 지면 고르기
지면을 읽어 오는 중…
2. 시안 파일 고르기
JPG·PNG·WEBP 그림이나 MP4 영상 하나. 이 상자에 끌어다 놓거나 아래 칸에서 고릅니다.
JPG·PNG·WEBP 그림과 MP4 영상을 봅니다. 형식은 파일 이름이 아니라 내용으로 정합니다. 고르면 이 브라우저가 먼저 파일 머리를 읽습니다. 4MB 이하 파일은 “규격과 견주기”를 누를 때 서버로 보내 서버가 다시 읽습니다. 그보다 큰 파일은 서버로 보내지 않고 읽은 값만 보냅니다.
검사 결과
아직 견준 결과가 없습니다. 지면과 시안 파일을 고르고 “규격과 견주기”를 누르면 항목별 결과가 여기에 나옵니다.
이 검사가 보는 것과 보지 않는 것
- 파일 형식 파일의 형식이 지면의 “소재 파일 형식” 목록에 드는가. 이름의 확장자가 내용과 다르면 내용을 기준으로 하고, 다르다고 적습니다.
- 해상도 가로·세로가 지면의 “해상도(px)”와 꼭 같은가. 다르면 비율만 같은지(크기만 바꾸면 되는지), 가로·세로가 뒤바뀐 것인지, 비율부터 다른지 갈라 적습니다.
- 길이 영상의 길이가 지면의 “한 번 길이(초)”와 같은가. 0.5초까지는 봐줍니다(근거를 재서 정한 값은 아닙니다). 그림에는 이 항목이 없습니다.
보지 않는 것: 문구·초상 같은 내용, 색과 밝기, 코덱·초당 장 수·소리, 화질. 용량은 읽어서 보여 주기만 합니다(지면에 용량 규격 칸이 없습니다). 움직이는 WEBP는 그림으로 읽고 길이는 읽지 않습니다. 영상의 길이는 파일 머리에 적힌 전체 길이입니다. 가로·세로는 저장된 픽셀 수이고, 영상에 회전 표식이 있으면 돌려서 보이는 크기로 바꿔 견줍니다. JPG 사진의 방향 표식(휴대전화 사진을 돌려 보여 주라는 표시)은 읽지 않고 저장된 크기 그대로 견줍니다. 파일을 풀어 보지 않으므로, 머리는 멀쩡한데 그림·영상 자료가 깨진 파일은 가려내지 못합니다. 읽지 못한 값은 짐작해 채우지 않습니다.
같은 일을 하는 curl
파일을 올리는 길(4MB까지. 서버가 파일 머리를 읽습니다)
curl -sS -X POST "/api/creative-checks" -F productId=<상품 번호> -F file=@시안.mp4
읽은 값만 보내는 길(큰 파일. 서버는 파일을 보지 못하고 보낸 값을 그대로 견줍니다)
curl -sS -X POST "/api/creative-checks" -H "Content-Type: application/json" -d '{"productId":1,"facts":{"format":"mp4","width":1920,"height":1080,"sizeBytes":180000000,"durationSeconds":15}}'공간 헤더(X-Workspace)를 빼면 본보기 공간의 상품과 견줍니다. 견주지 못하면 오류 본문 { code, message }로 답합니다: 없는 상품 404, 받지 않는 형식 415, 4MB를 넘는 파일 413, 머리를 읽지 못한 파일 422.