피드 보고서는 피드의 최신 처리 시도에 관한 세부정보를 보여 줍니다. 여기에는 피드를 구성하는 각 파일의 전체 상태, 사용 가능 여부 상태, 피드에서 발견된 모든 항목의 개수 및 상태가 포함됩니다. 지난 90일 동안 이 피드의 모든 피드 처리 기록을 확인할 수 있습니다. 속성의 각 피드에는 별도의 피드 보고서가 있습니다.
속성에 피드가 하나만 있으면 피드 보고서는 단순히 피드로 라벨이 지정됩니다. 속성에 여러 피드가 있으면 피드마다 피드의 고유한 이름으로 라벨이 지정된 자체 피드 보고서가 있습니다.
FAQ
피드에 대해 가장 일반적으로 필요한 정보를 찾는 방법은 다음과 같습니다.
최신 처리 상태
처리 기록 보기
지정된 상태의 항목 수
지정된 항목 유형의 상태 기록
Google의 항목 수
- 피드 보고서의 방문 페이지에서 처리 기록 보기를 클릭하고 처리 기록에서 가장 최근에 성공한 처리를 찾습니다. 처리 날짜와 시간을 기록합니다.
- 피드 보고서 방문 페이지로 돌아가서 감지된 항목 표를 찾습니다.
- 표에서 각 행을 클릭합니다(기타 항목 행 제외).
- 차트 위의 유효 및 유효(경고 있음)를 선택하고 무효를 선택 해제합니다.
- 1단계에서 기록한 날짜와 시간을 찾습니다.
- 감지된 항목 표에서 각 항목 유형의 수를 합산합니다.
- 피드 보고서에서 감지된 항목 표를 찾습니다.
- 항목 유형을 클릭하여 해당 유형의 문제 표를 확인합니다. 문제 표에서 특정 문제를 찾습니다.
- 문제 표의 행을 클릭하여 해당 문제의 영향을 받는 포괄적이지 않은 항목 목록을 확인합니다.
최신 처리의 항목 문제
- 표에서 행을 클릭하여 이 유형의 항목 기록을 확인합니다.
- 차트 상단에서 무효 또는 유효(경고 있음)를 선택하여 피드에 영향을 미치는 문제 목록을 확인합니다.
- 항목 개수 값이 0보다 큰 행을 클릭하여 이 문제의 영향을 받는 항목의 목록을 확인합니다. 개수가 0이면 최신 처리에서 문제가 해결된 것이지만 최신 처리에 실패한 경우 마지막으로 성공한 처리에 문제가 있을 수 있습니다.
- 항목 표 예에서 항목을 클릭하여 잘못된 코드를 확인합니다. 항목 표 예는 문제의 영향을 받는 모든 항목을 보여 주지 않을 수 있습니다.
처리 상태
피드 보고서 상단에 최신 처리 시도의 결과가 표시됩니다. 결과는 파일을 요청하고 파싱하는 기능 및 피드에서 발견된 항목의 유효성 등 여러 요소에 따라 달라집니다. 피드에 파일 수준 문제가 하나 있거나 항목 문제가 너무 많으면 처리에 실패합니다.
처리가 피드 보고서에 표시되는 데는 몇 시간이 걸릴 수 있습니다. 대부분의 처리는 정기적으로 예약되지만 일부 피드 처리는 다양한 이유로 자동 실행될 수 있습니다.
실시간 피드 상태
다음 상태는 실시간으로 표시된 피드에서 사용할 수 있습니다.
- 데이터가 처리되어 Google로 푸시됨
피드의 유효성 검사가 통과되었습니다. 피드의 유효한 모든 항목이 지식 그래프에 입력되었을 수 있습니다. 이 결과는 피드에서 유효한 항목이 하나 이상 감지되었다는 의미입니다. 피드가 성공적으로 처리되더라도 피드의 유효한 항목이 지식 그래프에 입력된다는 보장은 없습니다. 또한 오류가 사소하거나 해결 가능한 경우 일부 무효한 항목이 여전히 지식 정보에 입력될 수 있습니다. 자세히 알아보기 - 데이터가 처리되었지만 Google로 푸시할 수 없음
항목 불일치, 마지막 처리 이후 유효 항목 수의 급격한 변화 또는 기타 이유로 인해 처리가 거부되었습니다. Google의 피드 담당자에게 문의하여 문제와 문제 해결 방법을 알아보세요. 마지막으로 성공한 피드의 유효한 항목은 지식 정보에서 활성 상태로 유지됩니다. - 데이터 처리 실패: 피드 파일 문제
파일 수준 문제로 인해 처리가 거부되었습니다. 이 피드의 항목은 지식 그래프로 푸시되지 않습니다. 이 처리의 항목은 피드 보고서의 감지된 항목 섹션에 표시되지 않습니다. 표시된 항목은 유효하거나 '데이터가 처리되었지만 Google로 푸시할 수 없음'인 마지막 처리의 항목입니다. - 데이터 처리 실패: 빈 피드
모든 피드 파일이 비어 있거나 파일에 파싱 가능한 항목이 없습니다. 항목이 있지만 모든 항목에 오류가 있다면 데이터가 처리되었지만 Google로 푸시할 수 없는 경우입니다.
실시간이 아닌 피드 상태
다음 상태는 실시간이 아닌 피드에서 사용할 수 있습니다.
- 데이터가 처리됨
Google에서 피드를 읽고 파싱하여 초기 유효성 검사를 실행할 수 있습니다. 피드 보고서의 항목 표와 같이 피드에서 발견된 경고 또는 오류 문제를 검토하고 해결하세요. - 데이터 처리 실패: 빈 피드
모든 피드 파일이 비어 있거나 파일에 파싱 가능한 항목이 없습니다. - 데이터 처리 실패: 피드 파일 문제
파일 수준 문제로 인해 처리가 거부되었습니다. 이 처리의 항목은 피드 보고서의 감지된 항목 섹션에 표시되지 않습니다.
기타 정보
- '실시간' 배지
- '실시간' 배지는 한 번 이상 Google에 성공적으로 푸시된 후 피드에 표시됩니다.
- 시간
- 결과에서 보고된 처리 시간은 Google이 피드의 첫 번째 파일을 가져온(사용자 로컬) 시간입니다.
피드 파일
피드 파일 섹션에서는 피드의 파일을 읽을 수 있는지 보여 줍니다. 읽을 수 없는 파일이 있으면 처리에 실패합니다.
피드 파일 문제
다음 파일 수준 오류가 발생할 수 있습니다.
- 찾을 수 없음(404): 제공된 URL에서 피드 파일을 찾을 수 없습니다.
- 승인되지 않은 요청(401)으로 인해 차단됨: Google에서 피드 구성의 파일에 액세스하는 데 필요한 인증 정보를 모두 포함해야 합니다.
- robots.txt에 의해 차단됨: robots.txt 규칙이 피드를 차단하고 있습니다. 규칙을 찾아 수정하거나 삭제하세요.
- 서버 오류(5xx): 피드 파일을 읽는 중에 서버 오류가 발생했습니다.
- 리디렉션 오류: 리디렉션 루프 또는 잘못된 URL로의 리디렉션(유효하지 않은 것이 아니라 응답하지 않는 URL)과 같은 파일에 관한 일종의 리디렉션 오류입니다. 피드 파일 리더는 리디렉션을 따르지만 피드 파일이 영구적으로 이동하면 리디렉션을 지정하는 대신 피드 파일 설정을 업데이트해야 합니다.
- 액세스가 금지되어 차단됨(403): Google에서 액세스 제한으로 인해 파일을 읽을 수 없습니다. Google에서 피드 구성의 파일에 액세스하는 데 필요한 인증 정보를 모두 포함해야 합니다.
- 다른 4xx 문제로 인해 차단됨: 다른 문제로 인해 Google에서 이 피드 파일에 액세스할 수 없습니다.
- 파싱 문제: 치명적인 파싱 문제로 인해 전체 파일을 읽을 수 없습니다. 문제 설명을 클릭하여 파싱 오류가 포함된 스니펫을 확인하세요.
- 내부 오류: Google에 명시되지 않은 문제가 있어 나중에 다시 시도합니다.
- DNS 서버가 응답하지 않음: DNS 서버가 요청에 응답하지 않았습니다. Google은 주기적으로 피드 읽기를 다시 시도합니다.
- DNS 오류: 호스트 알 수 없음: DNS 서비스가 제공된 피드 URL을 인식하지 않았습니다. 일시적인 오류일 수도 있지만 제공된 URL을 확인하세요.
- DNS 오류: 비공개 IP 제공됨: DNS 서비스에서 DNS가 비공개 주소(예: 10.0.0.1)용으로 예약된 IP 주소를 반환했습니다. DNS 서비스 제공업체에 문의하세요.
- 서버 연결 오류: 5XX 수준의 오류가 발생했습니다(서버에 연결할 수 없거나 연결이 거부되었거나 응답하지 않음).
- 잘못된 서버 응답: 서버에서 요청된 프로토콜을 지원하지 않거나, 응답/헤더가 잘렸거나, 응답을 파싱할 수 없습니다(압축 오류 때문일 수 있음).
- 잘못된 서버 SSL 인증서: 사이트의 SSL 인증서가 유효하지 않습니다. SSL 인증서가 유효하지 않은 경우 Google에서 요청을 처리하지 않습니다.
- 가져왔지만 처리되지 않음: 피드의 파일을 가져오거나 처리할 수 없는 경우 Google에서 남은 파일을 가져오려고 시도하지만 처리하지 않으며 피드는 처리되지 않습니다. '가져왔지만 처리되지 않음'은 이러한 상황에서 가져오는 데 성공한 파일에 표시되는 라벨입니다.
감지된 항목
이 섹션에서는 이 처리에서 감지된 카테고리의 모든 최상위 항목(유형별로 그룹화됨)을 보여 줍니다.
최상위 항목 표
각 최상위 항목 유형의 경우 표에는 상태별 항목 수가 표시됩니다. 항목 유형의 세부정보를 보려면 표에서 항목 행을 클릭하여 항목 세부정보 페이지를 엽니다.
읽을 수 있는 파일이 없어서 처리에 실패하면 표의 값이 모두 0이 되지만 여전히 항목 행을 클릭하여 항목 유형의 처리 기록을 확인할 수 있습니다. Google은 마지막으로 성공한 처리의 항목을 계속 제공합니다.
기타 항목
기타 항목 유형(표시된 경우)에는 유형 설명이 누락되었거나 ID가 동일한 피드에 중복 항목이 있어서 제대로 입력할 수 없는 항목이 나열됩니다. 파싱할 수 없는 항목은 보고서에 전혀 포함되지 않습니다.
항목 세부정보 페이지
피드의 항목 표에서 행을 클릭하여 클릭한 항목 유형의 세부정보를 확인합니다.
항목 처리 기록 차트
항목 유형의 기록 차트는 각 처리의 각 상태에 있는 유형의 항목 수를 보여 줍니다. 차트의 데이터 포인트는 처리로, 성공 여부와는 관계없습니다. 차트는 Google의 인벤토리를 보여 주지 않지만 특정 처리의 주어진 상태에 있는 항목의 수를 보여 줍니다.
차트는 처리 포인트 간에 위쪽 또는 아래쪽 기울기를 보여 주지만 처리 시 모든 변경사항은 즉각 적용되므로 차트를 선 차트가 아니라 막대 그래프로 생각할 수도 있습니다(각 막대가 한 처리에서 다음 처리까지 시간의 길이).
차트 주석으로 실패한 처리를 표시합니다. 읽을 수 있는 파일이 없으면 차트는 처리의 모든 상태에서 0으로 떨어집니다.
항목 표
표는 최신 처리 시도에서 선택한 항목 유형의 상태 세부정보를 보여 줍니다.
- 표에서 행을 클릭하여 항목 예의 목록(1,000항목으로 제한)과 상태와 설명이 있는 항목의 기록 차트 등 상태와 설명이 있는 항목에 관한 추가 정보를 확인합니다.
- 표에서 항목 예를 클릭하여 오류가 강조표시된 항목 코드를 비롯하여 자세한 내용을 확인합니다(가능한 경우).
항목 상태
문제는 다음 상태 중 하나로 분류됩니다. 항목은 항목에 포함된 가장 심각한 문제에 따라 분류됩니다. 따라서 항목에 두 가지 문제, 즉 무효 하나와 유효(경고 있음) 하나가 있다면 항목 상태는 무효입니다.
- 무효: 이 항목은 피드에 제공된 상태로는 사용할 수 없습니다. 항목을 사용하려면 다음 피드 처리를 위해 항목을 업데이트하세요. 성공적으로 처리된 상태의 실시간 피드인 경우 무효한 항목이 Google에서 삭제됩니다.
- 유효(경고 있음): 이 항목은 제공된 상태로 사용할 수 있습니다. 그러나 수정이 필요할 수 있습니다. 경고는 변경해야 하는 사항(예: 지원 중단된 필드 사용)에 관한 것이거나 추가 정보(예: 가격)를 제공해야 한다는 것일 수 있습니다. 이러한 문제 중 일부는 향후 오류가 될 수 있습니다.
- 유효: 이러한 항목은 지식 그래프에 포함될 수 있습니다. 유효한 항목 목록을 보려면 피드 보고서의 요약 페이지에서 그래프 아래에 있는 유효한 항목에 관한 데이터 보기를 클릭하세요.
피드 디버깅
피드 디버깅은 반복 프로세스입니다. 피드 보고서를 사용하여 버그를 찾아 수정한 다음, 보고서의 다음 피드 처리에서 수정사항을 추적하세요.
문제는 최상위 항목 유형별로 그룹화됩니다. 모든 유형의 문제가 아니라면 한 인스턴스에서 문제를 검사하고 항목 생성 코드를 수정하여 대부분의 특정 문제를 해결할 수 있습니다.
데이터 피드 유효성 검사 도구를 사용하여 개별 항목의 유효성을 검사할 수 있습니다.
항목 문제를 해결하려면 다음 단계를 따르세요.
- 피드 보고서 하단의 표에서 항목 유형 목록을 확인합니다. 무효 항목을 1개 이상 표시하는 행을 클릭합니다.
- 피드에서 오류 상태의 항목 기록을 보려면 무효 탭을 선택해야 합니다.
- 보고서 하단의 오류 세부정보 표에서 오류 목록을 확인합니다.
- 오류를 클릭하여 오류가 있는 항목의 기록과 최신 처리 시도에서 이 오류가 있는 항목의 예를 확인합니다. 항목 예 목록은 여러 가지 이유로 꼭 완전한 것은 아닙니다. 그러나 차트에 표시된 이 오류의 영향을 받는 항목의 개수는 정확합니다.
- 예시 목록의 항목을 클릭하여 오류가 강조표시된 코드를 확인합니다(강조표시가 모든 오류에 지원되지는 않음). 자세히 알아보기 링크를 클릭하여 오류에 관해 자세히 알아보세요. 경우에 따라 추가 정보 패널에 수정에 대한 권장사항이 표시될 수 있습니다. 특정 항목에 관한 문서를 참고하여 필수 값이나 형식이 무엇인지 알아보는 것도 좋습니다.
- 업데이트된 피드를 생성하고, 데이터 피드 유효성 검사 도구를 사용하여 이전에 오류가 발생한 항목 한두 개를 수정합니다.
- 문제가 없으면 피드를 업데이트하고 다음 처리 과정을 기다린 후 오류가 사라졌는지 확인합니다. 피드 보고서의 감지된 항목 테이블에서 항목 유형을 클릭한 다음 세부정보 표에서 문제를 클릭하여 특정 항목 유형의 특정 오류 유형에 관한 기록을 확인할 수 있습니다.
문제 유형
피드에는 피드 문제와 항목 문제가 있을 수 있습니다.
- 피드 문제에는 파일을 읽고 파싱하는 작업이 포함됩니다. 파일 문제가 있으면 처리에 실패합니다. 파일 문제 목록을 확인하세요.
- 항목 문제는 문법 오류 또는 필수 입력란 누락일 수 있습니다. 항목 문제는 피드의 항목을 지식 그래프의 항목과 조정하는 데 문제가 될 수도 있습니다. 자세히 알아보기
항목 문제
항목에는 문제가 하나 이상 그리고 동일한 문제의 여러 인스턴스가 있을 수 있습니다. 항목 문제를 디버그하려면 최신 피드의 보고서를 클릭하여 오류 및 경고를 확인한 다음, 특정 항목을 클릭하여 특정 문제의 영향을 받는 항목의 예시 목록을 확인합니다.
- 특정 오류 유형(예: 'name' 속성이 누락된 모든 항목)을 디버그하려면 특정 항목 유형을 드릴다운해야 합니다.
항목 문제 유형
항목에 파싱/규정 준수 문제 또는 일치 문제가 있을 수 있습니다. 피드 보고서는 이 두 가지 문제를 구분하지 않지만 문제 클래스를 알면 문제를 해결하는 데 도움이 될 수 있습니다.
- 파싱 또는 규정 준수 문제는 항목을 파싱할 수 없거나, 필수 값이 누락되었거나, 특정 입력란에 지원되지 않는 값이 있음을 의미합니다. 이러한 문제 유형의 경우, 문제 이름을 읽고 문제를 파악하고, 특정 항목 유형에 대한 문서를 읽고, 특정 항목에 필요한 사항을 확인하세요.
- [실험용] Google에서 피드의 항목과 지식 그래프의 항목을 일치시킬 수 없을 때 연결 문제가 발생합니다. 이러한 문제는 주로 피드 항목에 대한 데이터가 누락되었거나, 피드 항목에 대한 일부 정보가 Google이 해당 항목에 대해 가지고 있는 정보와 일치하지 않기 때문에 발생합니다. 이러한 문제의 트리거는 아직 개발 중이므로 먼저 파싱 또는 규정 준수 문제를 해결하는 데 집중하시기 바랍니다. 일치 문제를 디버그하는 방법을 알아보세요.