구조화 데이터 목록으로

태그 관리자로 구조화 데이터를 넣는 일의 판단

태그 관리자로 구조화 데이터를 넣는 방식은 구글의 동적 JSON-LD 지원을 근거로 검토할 수 있습니다. 채택 여부는 실제 페이지의 실행·렌더링과 테스트에서 데이터가 감지되는지에 따라 판단합니다.

목차

동적 삽입 지원과 채택 판단

핵심 답

태그 관리자로 구조화 데이터를 넣는 방식은 구글이 동적으로 삽입된 JSON-LD를 읽을 수 있다는 근거에 따라 검토할 수 있습니다. 채택 여부는 실제 페이지에서 실행된 뒤 데이터가 감지되는지 확인해 판단해야 합니다. 태그 관리 화면에 코드를 등록했다는 사실만으로 검색이 읽을 수 있는 상태라고 결론 내리지는 않습니다.

구글 검색 센터는 자바스크립트나 콘텐츠 관리 시스템의 위젯을 통해 페이지 콘텐츠에 추가된 JSON-LD도 읽을 수 있다고 설명합니다. 이 설명은 동적 삽입이라는 구현 방식의 가능성을 뒷받침합니다. 특정 태그 관리자의 설정이나 사이트마다 다른 실행 조건까지 정상 작동한다고 인정하는 근거는 아닙니다.

운영자는 기술적으로 가능한 방식인지와 현재 사이트에서 사용할 수 있는 방식을 따로 판단해야 합니다. 개발 담당자는 태그가 실제 페이지에 데이터를 추가하는지, 구글의 테스트에서도 그 결과가 발견되는지를 자료로 제시해야 합니다. 도입 결정을 내릴 때는 제품 이름이나 관리 편의성보다 적용 주소의 실행 결과를 먼저 요구합니다.

채택 판단 항목공식 근거로 확인되는 범위추가 확인이 필요한 조건
동적 JSON-LD 삽입구글이 동적으로 추가된 데이터를 읽을 수 있음해당 페이지에서 삽입 코드가 실제 실행되는지
자바스크립트 사용구글 검색이 자바스크립트를 실행함사이트의 실행 방식이 크롤링·렌더링 제한에 영향을 받는지
실제 페이지 테스트리치 결과 테스트에서 발견된 데이터와 렌더링된 코드를 조사할 수 있음채택하려는 방식으로 넣은 데이터가 감지되는지
검색 기능 표시올바른 마크업도 리치 결과 표시를 보장하지 않음기술 적용 완료와 검색 표시 평가를 따로 관리하는지

이 표는 태그 관리자 제품을 추천하거나 배제하기 위한 목록이 아닙니다. 운영자는 각 항목에 해당하는 근거가 있는지 따지고, 아직 자료가 없는 조건을 개발 요청서에 남깁니다. 실행 결과가 없는 상태에서는 채택을 확정하기보다 시험 적용 대상으로 관리합니다.

자바스크립트 실행의 제한사항

예외·주의

구글 검색 센터는 자바스크립트를 실행하더라도 크롤러의 접근과 렌더링에는 고려할 차이점과 제한사항이 있다고 설명합니다. 또한 구글봇과 웹 렌더링 서비스는 필수 페이지 콘텐츠에 기여하지 않는 리소스를 가져오지 않을 수 있다고 안내합니다. 운영자는 자바스크립트 실행 지원을 모든 관련 요청의 처리 약속으로 해석하지 않아야 합니다.

이 설명만으로 특정 태그 관리자의 리소스가 항상 제외된다고 단정할 수도 없습니다. 개발 담당자는 현재 사이트에서 삽입에 필요한 코드와 요청이 무엇인지 정리하고, 실제 테스트 결과와 연결해 원인을 좁혀야 합니다. 근거 없이 제품 전체를 문제로 지목하면 수정할 대상도 명확하게 정하기 어렵습니다.

적용 주소에서 실행하는 조사 순서

작업은 동적 삽입 가능성, 실제 페이지의 실행·렌더링, 구조화된 데이터 감지 결과 순으로 진행합니다. 앞에서 정한 기준을 적용하려면 태그 관리 화면의 설정 자료와 실제 페이지의 테스트 자료를 함께 준비해야 합니다. 마케팅 담당자는 대상 페이지와 변경 목적을 정리하고, 개발 담당자는 배포된 구현 방식과 조사 결과를 제출합니다.

  1. 개발 담당자가 구조화 데이터를 어떤 코드로 페이지에 추가하는지 설명합니다. 운영자는 동적 JSON-LD 삽입에 관한 구글의 설명이 그 방식의 검토 근거가 되는지 판단합니다.
  2. 개발 담당자가 적용 주소에서 삽입 코드의 실행 결과를 조사합니다. 태그 설정 내역과 실제 페이지에 추가된 데이터가 서로 연결되는지 기록합니다.
  3. 담당자가 리치 결과 테스트에 적용 주소를 입력해 실행합니다. 페이지 가져오기 결과를 읽고, 렌더링된 코드와 감지된 구조화된 데이터 항목을 조사합니다.
  4. 운영자가 자료를 근거로 채택 여부를 결정합니다. 결과가 불명확하면 완료 처리 대신 추가 조사할 항목과 담당자를 지정합니다.

구글의 리치 결과 테스트 도움말은 코드 입력 테스트와 실제 주소 테스트를 안내합니다. 태그 관리자의 실행을 판단할 때는 작성한 코드만 검사하지 말고 적용 주소를 테스트 대상으로 삼습니다. 코드 자체의 결과만으로는 그 코드가 페이지에서 실행되었는지 알 수 없기 때문입니다.

담당자가 준비할 결과 자료

실제 페이지 확인 항목확인할 결과미확인 시 개발 담당에게 요청할 내용
페이지 접근과 가져오기테스트가 적용 페이지에 도달했는지접근 실패 원인과 조사 대상 주소의 상태
삽입 코드 실행의도한 데이터가 실제 페이지에 추가되었는지삽입에 필요한 코드·요청과 실행 결과
렌더링된 코드추가하려던 JSON-LD가 코드에 포함되는지관리 화면의 코드와 실행 결과가 다른 원인
구조화된 데이터 감지테스트가 어떤 항목을 발견했는지발견된 항목과 이번 삽입 대상의 대응 관계

결과 자료에는 적용 주소, 사용한 사용자 에이전트, 배포 상태와 발견된 항목을 함께 기재합니다. 리치 결과 테스트는 스마트폰 또는 데스크톱 사용자 에이전트를 선택할 수 있으므로, 담당자는 어떤 조건으로 실행했는지 남깁니다. 이는 특정 조건을 정답으로 지정하는 규칙이 아니라 작업 결과를 설명하기 위한 실무 기록입니다.

개발 요청에는 단순히 정상 작동 여부를 묻기보다 표에서 비어 있는 결과를 지정합니다. 페이지 접근이 실패한 경우와 렌더링된 코드에 데이터가 없는 경우는 필요한 조사 자료가 다릅니다. 담당자가 실패한 단계를 기재하면 운영자는 어떤 근거가 아직 부족한지 판단할 수 있습니다.

태그 실행 기록을 과대평가하는 오류

태그 관리 화면의 실행 기록이나 분석 도구의 요청 기록을 구글이 데이터를 읽었다는 증거로 처리하기 쉽습니다. 이런 기록은 사이트 측에서 어떤 동작을 관측했는지 설명하는 자료로 사용해야 합니다. 검색의 렌더링 결과를 판단하는 자료와 같은 의미로 보고하지 않습니다.

구글 검색 센터는 클라이언트 측 분석이 구글봇과 웹 렌더링 서비스의 활동을 완전하고 정확하게 나타내지 못할 수 있다고 설명합니다. 분석 기록에 관련 활동이 없다는 이유만으로 검색이 페이지를 처리하지 않았다고 결론 내릴 수는 없습니다. 반대로 요청이 기록되었다는 사실만으로 이번 구조화 데이터가 감지되었다고 주장해서도 안 됩니다.

운영자는 자료마다 무엇을 입증하는지 이름을 붙여 관리합니다. 태그 실행 기록은 사이트 측 동작 자료로, 렌더링된 코드는 테스트에서 처리된 페이지 자료로, 감지 결과는 발견된 구조화 데이터 항목 자료로 기재합니다. 서로 다른 자료를 하나의 성공 표시로 합치지 않으면 개발 담당자가 해결해야 할 문제도 명확해집니다.

감지 결과와 검색 표시의 별도 보고

구글의 일반 가이드라인은 리치 결과 테스트에서 올바른 마크업으로 판정되어도 검색결과에 표시된다고 보장하지 않는다고 설명합니다. 따라서 적용 보고서는 데이터 감지 결과를 기술 작업의 결과로 기재하고, 실제 검색 기능 표시는 별도 평가 항목으로 관리합니다. 표시되지 않았다는 이유만으로 삽입 방식이 실패했다고 되돌려 판단하지 않습니다.

운영자는 완료 보고서에 수행한 테스트와 발견된 데이터를 구체적으로 씁니다. 리치 결과 노출 완료나 AI 검색 대응 완료처럼 검사 범위를 넘는 표현은 사용하지 않습니다. 특히 구글에서 얻은 테스트 결과는 다른 AI 검색 서비스가 같은 방식으로 처리한다는 근거가 되지 않습니다.

검색 표시를 조사해야 한다면 그 목적에 필요한 자료를 따로 정합니다. 태그 관리자 채택 판단 자료에 관측하지 않은 노출이나 인용 결과를 추가하지 않습니다. 기술 담당자가 제출할 자료와 마케팅 담당자가 평가할 자료를 나누어 요청합니다.

기존 데이터의 감지를 오인하는 경우

테스트가 데이터를 발견해도 이번에 태그 관리자로 추가한 항목이 발견되었는지는 별도로 가려야 합니다. 페이지에 원래 있던 구조화 데이터가 감지되었을 가능성을 배제하지 않은 채 새 방식의 성공으로 보고하면 채택 근거가 잘못될 수 있습니다. 개발 담당자는 이번 삽입 대상과 기존 항목의 관계를 설명합니다.

운영자는 새로 추가하려던 데이터의 대상과 주요 값을 작업 요청서에 기재합니다. 결과를 받을 때는 그 항목이 렌더링된 코드와 감지 결과의 어디에 해당하는지 연결해 달라고 요청합니다. 기존 항목만 발견되었다면 테스트 자체는 실행되었어도 새 삽입 방식의 채택 판단은 아직 끝나지 않은 상태로 처리합니다.

자주 묻는 질문

개발 담당자의 협조 없이 태그 관리자를 채택해도 됩니까?

관리 화면을 운영할 수 있다는 이유만으로 개발 담당자의 역할까지 생략하는 것은 권하지 않습니다. 실행 문제의 원인을 조사하고 배포 상태를 설명할 담당자가 필요합니다. 운영자는 도입 전에 누가 기술 자료를 제출하고 문제가 생겼을 때 누가 수정할지 정합니다.

태그 관리자에서 직접 삽입하는 방식으로 변경해야 합니까?

태그 관리자라는 이유만으로 직접 삽입 방식으로 변경할 필요는 없습니다. 현재 방식의 실행 결과가 충분히 입증되고 유지 관리 책임도 명확하다면 변경 이유부터 정리합니다. 방식 변경을 검토할 때는 관리 편의와 문제 해결에 필요한 작업도 함께 따집니다.

사용자의 동의 이후에만 실행하는 설정은 어떻게 판단합니까?

이 조건의 동작을 모든 태그 관리자에 공통인 규칙으로 단정할 수는 없습니다. 개발 담당자에게 동의 상태가 삽입 코드의 실행에 어떤 영향을 주는지 설명하도록 요청합니다. 채택 자료에는 그 조건과 실제 조사 결과를 연결해 기록합니다.

외부 태그 서비스에 장애가 생길 때를 대비해야 합니까?

외부 서비스에 의존하는 구현을 선택한다면 장애 대응 책임도 정하는 편이 좋습니다. 운영자는 문제가 생겼을 때 구조화 데이터 삽입 상태를 조사할 담당자와 복구 절차를 마련합니다. 이는 구글의 요구 조건으로 단정할 사항이 아니라 회사의 운영 위험을 관리하는 절차입니다.

시험 적용을 중단할 때 어떤 작업을 함께 요청해야 합니까?

태그 등록만 삭제하지 말고 실제 페이지에서 시험용 데이터가 제거되었는지 조사하도록 요청합니다. 다른 삽입 경로를 통해 같은 데이터가 남는지도 개발 담당자가 설명해야 합니다. 중단 기록에는 제거 대상과 최종 배포 상태를 기재해 이후 작업에서 시험용 항목을 운영 데이터로 오인하지 않도록 합니다.

맨 위로 이동

구조화 데이터 서비스 자세히 보기