이 확장 가이드는 아드리엘에서 데이터 로드 문제를 체계적으로 해결하기 위한 중요 단계를 제공합니다. 다음 단계를 따라 문제를 식별하고 효과적으로 해결하세요.
요약
1. 정보 수집: 아이콘 확인
아드리엘 대시보드의 알림 또는 정보 아이콘을 확인하세요. 이는 API 문제와 같은 잠재적 문제에 대한 초기 단서를 제공합니다.
아이콘 의미
- 알림 아이콘 (⚠️): 주요 문제를 나타냅니다.
- 연결 끊김
- 인증 오류
- 지원되지 않는 데이터 형식 등
아이콘을 클릭할 수 있는 경우, 상세 오류 로그나 지원 문서를 확인할 수 있습니다.
- 로딩 아이콘 (🔄): 데이터 동기화 중을 나타냅니다.
- 외부 플랫폼 문제로 인한 동기화 지연
- 선택한 데이터 소스 및 날짜 범위에 데이터가 없는 경우 "표시할 데이터 없음" 메시지 표시
Pro Tip: 특정 뷰를 열 수 없는 경우, 데이터 접근 권한이 올바른지 확인하세요.
- 워크스페이스 설정에서 사용자 역할 및 권한 확인
- 필요한 권한이 있는지 점검
2. 문제 해결 단계
- 새로운 소스를 연결한 후에는 데이터 로드가 완료될 때까지 최대 30분을 기다려주세요.
- 이미 연결된 데이터 소스의 경우, 몇 분 안에 로드가 완료되지 않으면 페치가 시간 초과될 수 있습니다. 상단 네비게이션 바의 "데이터 새로고침(Refresh Data)" 버튼을 선택하여 데이터를 다시 로드하세요.
1단계: 위젯의 데이터 소스 확인
- 위젯 설정을 열고 필요한 데이터 소스가 모두 활성 상태인지 확인하세요.
- 연결 끊김이나 오류가 있는 경우 알림 아이콘(⚠️)으로 알림을 받습니다.
데이터 연결 페이지로 이동하여 끊어진 데이터 소스를 다시 연결하거나 재인증하세요.
2단계: 날짜 범위 확인
- 선택한 날짜 범위가 기대하는 데이터 기간을 포함하는지 확인하세요. 시작 날짜와 종료 날짜가 정확한지 확인하세요. 날짜에 대한 자세한 정보는 이 가이드를 참조하세요 (한국버전 진행 중).
중요: 선택한 필터와 날짜 범위 내에서 소스 데이터베이스나 플랫폼에 데이터가 포함되어 있는지 확인하세요.
아드리엘의 데이터와 교차 검증하여 데이터가 원본 소스 데이터와 일치하는지 확인하세요.
3단계: 필터 검토
필터가 적절히 설정되었는지 확인하세요.
- 팀스페이스 필터
- 대시보드 수준의 데이터를 필터링하지 않는지 확인하세요.
- 뷰 수준 및 위젯 수준 AND/OR/EXCLUDE 필터
- 상단 네비게이션 바의 필터 아이콘에서 뷰 수준 필터와 개별 위젯 데이터 설정 내의 위젯 필터를 다시 확인하여 필터가 올바르게 설정되었는지 확인하세요.
- 필터에 대한 자세한 정보는 이 가이드를 참조하세요.
작업을 잃지 않으려면 위젯이나 보기를 복제하여 테스트를 실행해 보세요! 여러 필터가 적용된 경우, 하나씩 제거하여 잠재적인 충돌을 분리하고 어떤 필터가 작동하는지 확인하세요.
4단계: 데이터 블렌드 구성 확인
데이터 블렌드 기능을 사용하는 경우 다음을 확인하세요:
- 커스텀 데이터셋이 아드리엘의 형식 요구사항에 맞는지 확인 (예: BigQuery, CSV, Google Sheets).
- 스키마 일관성 및 날짜 형식 유효성 점검.
- 데이터셋 간 LEFT JOIN 및 FULL JOIN 키가 올바르게 구성되었는지 확인.
데이터 블렌드는 복잡할 수 있습니다. 도움이 필요하면 이 폼 통해서 바로 문의하세요.
3. 고급 문제 해결
문제가 지속된다면, 다음의 고급 전략을 고려해 보세요:
다운타임 및 API 제한 확인
- 데이터 소스 연결이 활성 상태인지, 다운타임이 발생하지 않는지 테스트하세요.
- 많은 플랫폼에서 API 요청이나 데이터 내보내기에 대한 할당량을 적용합니다.
- 할당량을 초과한 경우 동기화가 일시 중단될 수 있으므로 리셋 기간을 기다리거나 플랫폼에 문의하세요.
Pro Tip: 아드리엘의 연결 팀은 API 제한이나 다운타임을 적극적으로 모니터링하고 있습니다. 데이터 소스 오류 패널 또는 챗봇을 통해 API 데이터 추출 및 로드 관련 문제에 대한 로그나 오류 메시지를 확인하세요.
아드리엘 지원팀에 문의
- 발생한 오류가 제공된 목록에 없는 경우, 저희 팀에 문제를 공유해 주시면 원인을 조사하겠습니다.
지원팀에 문의할 때 다음 정보를 포함해 주세요:
- 영향을 받은 대시보드의 URL
- 오류 메시지 또는 아이콘의 스크린샷
- 영향을 받은 데이터 소스 및 위젯에 대한 설명
4. 데이터 위생: 예방 팁
- 아드리엘 알림: 데이터 소스 연결 해제 및 플랫폼 API 업데이트에 대한 알림을 모니터링하여 워크스페이스가 최신 상태인지 확인하세요.
Pro Tip: 데이터 소스가 해제될 때 알림을 받을 수 있도록 아드리엘의 알람 기능을 활용하세요.
- 유지보수, 업데이트 또는 정책 변경에 대한 알림을 챗봇 통해서 확인하세요.
- 필터를 간소화하고 최소한의 구체적인 필터를 사용하여 쿼리 복잡성을 줄이세요.
- 광고 플랫폼 또는 데이터베이스에 예상 데이터가 포함되어 있는지 확인하세요.
이 가이드를 따르면 대부분의 데이터 로드 문제를 효율적으로 해결할 수 있습니다. 문제가 지속되면 아드리엘 지원팀에 문의하세요! 😊
부록: 오류 메시지 참조
다음은 일반적인 오류 메시지와 해결 방법입니다:
|
오류 메시지 |
의미 |
조치 |
|
연결 오류 |
데이터 소스 연결 끊김 |
데이터 소스를 다시 연결하세요. |
|
인증 필요 |
자격 증명 만료 또는 유효하지 않음 |
자격 증명을 업데이트하고 재인증하세요. |
|
지원되지 않는 데이터 형식 |
아드리엘 형식 요구사항과 불일치 |
데이터를 다시 포맷하여 업로드하세요. |
|
API 사용 한도 초과 |
API 사용량 제한 초과 |
리셋을 기다리거나 플랫폼에 문의하세요. |
|
잘못된 날짜 범위 |
선택한 날짜 범위가 제한 초과 |
날짜 범위를 조정하세요. |
|
누락된 데이터 소스 |
필요한 데이터 소스 누락 |
위젯 설정에서 누락된 소스를 추가하세요. |