오류

문제가 발생하면, 저희 오류 메시지는 보통 아래와 같은 형식으로 표시되어 원인을 더 쉽게 파악할 수 있습니다.

[문제 카테고리] 오류 유형 - 세부 정보 (요청 ID)

• *문제 카테고리(issue category)*는 문제가 발생한 위치를 설명합니다.
• *오류 유형(error type)*은 어떤 종류의 문제인지 설명합니다.
• *세부 정보(details)*에는 해당 문제에 대한 추가 정보와 해결 방법에 대한 제안이 포함됩니다.
• *요청 ID(request id)*는 Ahrefs API로 전송된 호출을 추적하기 위한 식별자입니다.

문제를 해결할 수 없는 경우, 지원팀에 문의하실 때 아래 정보를 함께 제공해 주세요.

• 문제가 있는 차트에서 사용한 필드, 날짜 범위, 매개변수, 필터가 보이도록 캡처한 스크린샷.
• 또한 차트에 오류가 표시된다면 요청 ID와 오류 메시지도 함께 제공해 주세요.

문제 카테고리

커넥터 구성 문제

데이터 소스가 잘못 구성되어 문제가 발생했습니다. 올바른 설정으로 데이터 소스를 다시 연결해 주세요.

차트 문제

데이터 소스 설정은 올바르지만, 차트를 만들 때 데이터 소스를 부적절하게 사용하여 문제가 발생했습니다. 오류 세부 정보에는 차트 속성 패널에서 무엇을 변경해야 하는지에 대한 추가 정보가 제공됩니다.

액세스 문제

인증에 사용된 Ahrefs 계정에 커넥터를 사용할 수 있는 권한이 충분하지 않습니다. 이 오류가 표시되었지만 구성된 Ahrefs 프로젝트에 접근 권한이 있는 지원되는 요금제를 사용 중이라면, 요청 ID와 함께 지원팀에 문의해 주세요.

Ahrefs API 문제

Ahrefs API에 문제가 있습니다. Ahrefs 대시보드에서 상태 업데이트를 확인하거나, 요청 ID와 함께 지원팀에 문의해 주세요.

오류 유형

누락/유효하지 않은 구성 매개변수

필수 구성 매개변수의 값이 제공되지 않았거나, 제공된 값이 예상 형식과 일치하지 않습니다. 유효한 값은 데이터 소스를 다시 연결하여 전역으로 제공하거나, 보고서에서 매개변수를 재정의하여 로컬로 제공할 수 있습니다.

각 Ahrefs 필드 그룹은 유효한 구성으로 간주되는 조건에 추가 제한을 부과할 수 있습니다. 따라서 전역적으로는 유효한 데이터 소스 구성이라도 차트를 만들 때 이 오류가 발생할 수 있습니다.

유효하지 않은 필드 조합

유효하지 않은 필드 조합이 요청되었습니다. 저희 커넥터는 사용 편의를 위해 여러 소스의 필드를 Ahrefs 보고서 유형으로 분류하므로, 모든 필드가 서로 호환되는 것은 아닙니다. 각 커넥터의 필드 참조에는 함께 요청할 수 있는 필드가 무엇인지 설명되어 있습니다.

자세한 내용은 필드 분류를 참고하세요.

유효하지 않은 날짜 범위

유효하지 않은 날짜 범위가 요청되었습니다. 이는 일부 커넥터의 필드 그룹이 날짜 범위를 특수한 방식으로 사용하기 때문에 발생할 수 있습니다.

날짜 범위 참조에는 각 필드 그룹이 날짜 범위 매개변수를 어떻게 사용하는지 설명되어 있습니다.

자세한 내용은 날짜 범위 사용을 참고하세요.

지원되지 않는 필터

지원되지 않는 연산자를 사용하는 필터가 적용되었습니다.

현재 "정규식 포함" 필터 연산자는 지원하지 않습니다.

알 수 없는 필드

필드가 요청되었지만(측정기준, 측정항목 또는 필터 표현식의 일부로), 해당 식별자를 Ahrefs API가 인식하지 못합니다. 즉, 데이터 소스가 Ahrefs API와 동기화되지 않은 상태입니다. 대개 데이터 소스 필드를 새로고침하면 문제를 해결할 수 있습니다. 다만, 이 작업을 수행하면 해당 데이터 소스를 사용하는 기존 보고서가 손상될 수 있으니 유의하세요.