sellers.json 검사기
브라우저 처리광고 시스템이 공개하는 sellers.json의 version·연락처, 판매자별 seller_id 중복, seller_type(PUBLISHER·INTERMEDIARY·BOTH), 공개 판매자의 name·domain 누락과 형식을 검사하고 판매자 수와 비공개 수를 세어 줍니다.
sellers.json은 광고 네트워크나 SSP가 '우리를 통해 지면을 파는 판매자는 누구인지' 공개하는 파일입니다. 광고 구매자는 ads.txt와 sellers.json을 맞춰 보며 지면의 판매 경로가 투명한지 확인합니다.
✓ sellers.json 구조 검사를 통과했습니다. 판매자: 3 · 고유 ID: 3 · 비공개: 1
sellers.json 검사기 사용 가이드
sellers.json은 광고 네트워크나 SSP가 '우리를 통해 지면을 파는 판매자는 누구인지' 공개하는 파일입니다. 광고 구매자는 ads.txt와 sellers.json을 맞춰 보며 지면의 판매 경로가 투명한지 확인합니다.
이 검사기는 최상위에 sellers 배열이 있는지, version과 contact_email·contact_address가 있는지 확인하고, 판매자마다 seller_id가 있고 겹치지 않는지, seller_type이 정해진 세 값 중 하나인지 봅니다.
비공개(is_confidential)가 아닌 판매자에게 name이 없거나, domain이 빠졌거나 https://가 붙어 있으면 알려 줍니다. JSON 문법이 틀리면 오류 위치를 한국어로 보여 줍니다.
사용 방법
- 'sellers.json 내용' 칸에 파일 내용을 붙여 넣습니다.
- '실행'을 누르면 구조 검사 결과와 ⚠ 판매자별 문제가 나옵니다.
- 판매자 번호(#1, #2…)를 보고 해당 항목을 고칩니다.
- 판매자 수, 고유 ID 수, 비공개 수 요약으로 전체 규모를 확인합니다.
예시: 판매자 3명, 1명은 비공개
{"contact_email": "[email protected]", "version": "1.0", "sellers": [ {"seller_id": "1001", "seller_type": "PUBLISHER", "name": "예시상점", "domain": "shop.example.com"}, {"seller_id": "1002", "seller_type": "INTERMEDIARY", …}, {"seller_id": "1003", "seller_type": "PUBLISHER", "is_confidential": 1} ]}✓ sellers.json 구조 검사를 통과했습니다. 판매자: 3 · 고유 ID: 3 · 비공개: 1
domain에 https://a.com처럼 주소를 넣으면 '도메인만 적습니다' 경고가 나옵니다.
이럴 때 쓰면 좋아요
- 광고 네트워크가 sellers.json을 처음 공개할 때
- 게시자 정보가 바뀐 뒤 파일을 다시 점검할 때
- ads.txt의 게시자 ID가 sellers.json에 있는지 대조하기 전에
- 중복 seller_id 때문에 생긴 오류를 찾을 때
문제가 생겼을 때
검사는 대소문자를 구분하지 않지만 IAB 규격은 대문자 PUBLISHER, INTERMEDIARY, BOTH를 씁니다. 대문자로 맞추세요.
seller_id는 판매자마다 고유해야 합니다. 계정이 합쳐졌다면 하나만 남기세요.
is_confidential이 1이면 name과 domain을 비워도 됩니다. 이 경우 경고를 띄우지 않습니다.
활용 팁
- 파일은 광고 시스템 도메인의 최상위(https://도메인/sellers.json)에 둡니다.
- domain에는 판매자의 사업 도메인만 적습니다(예: shop.example.com).
- 규모가 큰 파일은 JSON 문법부터 JSON 검증기로 확인하면 오류 위치를 찾기 쉽습니다.
자주 묻는 질문
아니요. sellers.json은 광고 네트워크·SSP 같은 광고 시스템이 공개하는 파일입니다. 사이트 운영자는 ads.txt만 관리하면 됩니다.
파일 구조만 봅니다. 판매자 회사나 도메인이 실제로 있는지는 확인하지 않습니다.
오류 메시지의 위치(줄·열)를 보고 쉼표나 따옴표가 빠진 곳을 찾으세요. 마지막 항목 뒤 쉼표도 흔한 원인입니다.