1. 보고서 상태 가져오기에서 반환된 오류 코드를 확인하고 오류 코드 색인을 사용하여 실패 원인을 찾을 수 있는지 확인하세요.
2. 문제가 지속되면 Singular 지원팀에 문의하세요. 지원팀에서 오류를 반환한 특정 API 호출을 찾고 완료할 수 없는 기술적 이유를 확인할 수 있으므로 보고서 ID를 저장해 두는 것이 좋습니다.

일반적으로 어제 데이터는 현지 시간대 기준 오전 8시까지 준비되어야 합니다. 데이터가 준비되지 않았다면 데이터 가용성 엔드포인트에서 반환되는 'status' 매개변수를 확인하세요. 여기에는 문제에 대한 자세한 정보가 포함될 수 있습니다(자세한 내용은 데이터 가용성 엔드포인트 참조 참조). 로그인 문제가 있는 경우(Singular가 데이터를 가져오기 위해 소스에 로그인할 수 없음), Singular 앱의 데이터 커넥터 페이지로 이동하여 자격 증명을 다시 입력하세요.

그러나 로그인 오류와 같이 즉시 식별할 수 있는 문제가 아닐 수도 있습니다. 데이터 가져오기는 여러 가지 이유로 지연될 수 있습니다. 데이터 지연에 대해 자동으로 알림을 받고 즉시 문제 해결을 시작한다는 점에 유의하세요. 그 동안에는 다음과 같이 할 수 있습니다:

• 다른 모든 네트워크를 쿼리하고 지연된네트워크는 나중을 위해 남겨둡니다.
• 1시간 이상 기다렸다가 다시 확인
• 긴급한 경우 기다렸는데도 여전히 소스가 채워지지 않는다면 Singular 지원팀에 알릴 수 있지만, 이미 작업 중일 수 있다는 점을 염두에 두세요.

N/A 값이 표시되는 이유를 이해하려면 보고서에서 'N/A' 및 누락된 데이터 문제 해결을 참조하세요.

간혹 캠페인의 모든 지표가 한 행에 표시되는 대신, 애드 네트워크 지표(예: 비용)가 한 행에 표시되고 어트리뷰션 트래커 지표(예: 인스톨)가 두 번째 행에 표시되는 경우가 있습니다.

이런 일이 발생하는 이유를 이해하려면 네트워크 및 트래커 데이터 조인 ( Singular 보고 데이터 이해 가이드의 일부)을 참조하세요.

쿼리에 존재하지 않는 필터가 포함된 경우 이 오류가 발생합니다. 예를 들어 앱 페이지에 존재하지 않는 앱이나 전혀 존재하지 않는 OS를 기준으로 필터링하려고 시도했을 수 있습니다. 반환된 필터 값을 검토하여 쿼리를 적절하게 수정하세요.

필터링할 수 있는 모든 필드와 각 필드에 유효한 모든 값의 목록을 얻으려면 필터 엔드포인트를 사용하세요.

쿼리에 사용자 정의 기준을 포함했다면 사용자 정의 기준 엔드포인트를 사용하여 해당 기준을 계속 사용할 수 있는지 다시 확인하세요. 쿼리 작성 이후 사용자 정의 기준 구성 페이지에서 사용자 또는 팀이 변경한 경우 이 오류가 발생할 수 있습니다.

또한 사용자 지정 기준의 경우 '표시 이름'이 아닌 기준 ID를 사용해야 합니다.

사용자 지정 기준 FAQ에서 자세히 알아보세요.

쿼리에 코호트 메트릭 또는 이벤트를 포함한 경우, 코호트 메트릭 엔드포인트를 사용하여 사용한 메트릭과 기간을 사용할 수 있는지 다시 확인하세요. '표시 이름'이 아닌 메트릭 이름을 사용했는지 확인하세요.

시간이 지남에 따라 데이터가 변경될 수 있는 이유 중 하나는 Singular가 네트워크와 트래커에서 보고한 데이터를 그대로 표시하기 때문입니다. 이러한 파트너 중 일부는 최종 데이터를 확보하기 전에 추정 데이터를 보고할 수 있습니다. 예를 들어 트위터는 "트위터 보고는 노출이 제공된 후 24-48시간 이내에 완료됩니다. 그 전에는 실시간 피드백을 제공하기 위해 데이터를 추정하지만, 데이터는 변경될 수 있습니다."(출처)라고 명시하고 있습니다.

이는 데이터를 가져오는 일부 애드 네트워크의 기술적 문제에 대한 해결 방법으로 인해 발생합니다.

캠페인 내의 크리에이티브에 대한 광고 네트워크의 지표가 캠페인에 대한 광고 네트워크의 지표와 정확히 합산되지 않는 경우가 있습니다.

예를 들어, 크리에이티브 수준에서 가져온 데이터는 최대 50회의 클릭을 추가하지만 캠페인 수준에서 가져온 데이터는 동일한 캠페인에 대해 45회의 클릭을 표시하는 경우가 있습니다:

이러한 경우, 데이터를 정렬하기 위해 Singular는 데이터베이스에 더미 광고 소재 행을 추가하고 광고 소재의 지표가 전체 캠페인의 지표에 합산되도록 필요한 값을 부여합니다. 이 값은 때때로 음수일 수 있습니다. 이 더미 행의 크리에이티브 이름은 "누락된 크리에이티브 데이터"로 지정됩니다.

이러한 더미 행은 일반적으로 API 결과에만 표시됩니다 (Singular 웹 플랫폼에서 실행하는 보고서에는 표시되지 않음). 쿼리에 다음을 추가하여 숨길 수 있습니다: display_alignment=False

Creative 보고서 FAQ 및 문제 해결에서 자세히 알아보기

Singular는 행의 다른 지표를 기반으로 계산되는 일부 지표를 제공합니다. 예를 들어 CPI(설치당 비용)는 비용을 설치 수로 나눈 값입니다. 집계 쿼리("+" 연산으로 메트릭을 합산하는 경우)에서는 의미 없는 결과를 얻을 수 있으므로 이러한 메트릭은 API 보고서에서 사용하지 않는 것이 좋습니다 .

예를 들어

쿼리에 creative_id, creative_name, asset_id, asset_name 등과 같은 크리에이티브 기준이 포함되어 있는지 확인합니다. 구글 애즈와 같은 일부 네트워크는 캠페인별로 국가 데이터를 제공하지만 크리에이티브별로 국가 데이터를 제공하지 않으므로, 보고서가 크리에이티브별로 분류된 경우 국가 정보를 볼 수 없습니다.

Google 광고 기능 및 제한 사항에 대한 자세한 내용은 애드워즈(Google 광고) 데이터 커넥터를 참조하세요.

Singular API와 Singular 사용자 인터페이스(app.singular.net)는 동일한 코드를 사용하여 Singular 데이터베이스에서 데이터를 가져오므로 결과는 항상 일치해야 합니다. 그렇지 않다면 정확히 동일한 쿼리를 실행하지 않았을 가능성이 높습니다.

특히 다음과 같은 차이점에 주의하면서 Singular 사용자 인터페이스의 쿼리 설정과 API 쿼리를 비교해 보세요:

• 서로 다른 날짜 집합 쿼리
• 일반 지표 대신 불일치 지표 사용
• 크리에이티브 보고서에 더미 행 표시('크리에이티브 이름' 기준에 '누락된 크리에이티브 데이터'가 표시되는 이유는 무엇인가요? 참조).

개발자 도구를 사용하여 UI를 사용할 때 실행되는 get_new_data API 호출을 확인할 수도 있습니다.

비동기 보고서는 동시에 100개만 실행할 수 있습니다. 이미 100개의 보고서를 제출한 경우 보고서가 완료될 때까지 기다렸다가 다른 보고서를 제출하세요.

이 오류는 여러 가지 이유로 발생할 수 있습니다. 잠시 기다렸다가 API 호출을 다시 시도하세요. 매일 동일한 코드를 실행하여 보고서를 가져오는 경우 500 오류가 발생할 경우 코드에 재시도를 추가해야 합니다.

문제가 지속되면 Singular 지원팀에 문의하세요.

대부분의 네트워크에서 Singular는 매일 데이터를 새로 고치므로 매일 보고서를 실행하는 것이 좋습니다. 데이터를 더 자주 쿼리할 이유는 없습니다. 자세한 내용은 일일 보고서 실행하기를 참조하세요.