대상별 식별자 표를 만듭니다
법적 운영 조직, 브랜드, 웹사이트, 개별 문서와 서비스의 대상이 무엇인지 적습니다. 각 ID가 어떤 사실을 대표하는지 설명할 수 있어야 합니다. 문서마다 생성되는 임의 문자열을 조직 ID로 사용하면 같은 조직을 연결하기 어렵고, 모든 문서에 같은 페이지 ID를 쓰면 다른 콘텐츠가 합쳐질 수 있습니다.
공통 노드와 페이지 노드를 나눕니다
이름·로고·연락처처럼 공통으로 관리할 조직 정보와 제목·게시일·주소처럼 문서마다 다른 정보를 구분합니다. 공통 정보를 바꾸는 기준은 한 곳에 두되 페이지의 실제 내용과 맞는지 확인합니다. 문서의 작성자와 게시자를 참조할 때 관계없는 브랜드나 이전 호스트의 ID가 남지 않는지도 봅니다.
검사할 연결을 정합니다
- 각 ID의 정의가 동일한 대상과 값으로 유지되는지 확인합니다.
- author·publisher 등 참조가 의도한 조직을 가리키는지 봅니다.
- 페이지의 주소와 문서 ID가 실제 canonical 정책과 맞는지 확인합니다.
- 같은 페이지 안에서 공통 레이아웃과 본문이 같은 노드를 중복 생성하는지 검사합니다.
가정한 예로 레이아웃이 조직 정보를 만들고 각 글이 또 다른 조직 ID를 자동 생성하면 이름이 같아도 연결이 흐려질 수 있습니다. 반대로 서로 다른 법적 조직을 하나의 ID로 묶는 것은 더 큰 의미 오류입니다. 코드 재사용을 위해 관계의 사실을 바꾸지 말고 대상별 책임을 정합니다.
도메인 이전 때의 검토
공개 URL을 ID의 기준으로 사용했다면 새 호스트로 옮길 때 어떤 식별자가 바뀌고 어떤 대상을 계속 같은 것으로 설명할지 정리합니다. 화면의 브랜드 관계와 URL 매핑을 함께 확인합니다. 옛 주소가 남은 노드를 관련 개체 확인 없이 문자열 치환하기 전에 실제 대상의 공식 주소가 무엇인지 확인해야 합니다.
완료 판정
식별자 표와 실제 JSON-LD 그래프를 다른 개발자가 대조할 수 있어야 합니다. 문법 검증, ID 충돌 검사와 관계의 의미 검수를 분리해 기록합니다. 안정적인 ID를 넣었다는 사실만으로 외부 지식 그래프 등록이나 특정 AI 서비스의 브랜드 인식이 완료됐다고 보고하지 않습니다.
자주 묻는 질문
- 모든 JSON-LD 노드에 같은 ID를 써도 되나요?
- 같은 대상을 가리킬 때만 같은 식별자를 사용합니다. 조직, 브랜드, 웹사이트와 개별 글은 서로 다른 대상이므로 이름이 비슷하다고 하나로 합치지 않습니다.
- 여러 Organization이 있으면 무조건 오류인가요?
- 타입의 개수만 세지 말고 각 노드가 설명하는 대상과 ID를 확인합니다. 법적 운영자와 실제 브랜드 조직 등 구별할 이유가 있다면 관계를 표현하고, 같은 ID의 충돌이나 중복을 별도로 검사합니다.
공식 참고자료와 작성 기준
공식 문서는 도구·검색 기능의 근거이며, 위의 점검 순서와 완료 기준은 현랩의 실무 설계 제안입니다. 예시를 실제 고객의 성과나 검색엔진의 보장으로 해석하지 않습니다.