광고 검사기를 사용하면 앱의 문제를 식별할 수 있습니다. 문제가 식별되면 이 도움말의 정보를 사용하여 문제를 해결하는 방법을 알아볼 수 있습니다.
이 도움말의 내용
SDK 어댑터 문제 파악하기
서드 파티 광고 소스의 SDK 어댑터를 확인할 때 두 가지 문제가 발생할 수 있습니다. 다음을 검토하여 문제 및 해결 방법을 파악하세요.
| 문제 | 의미 | 취할 수 있는 조치 |
|---|---|---|
| 어댑터를 찾을 수 없음 |
일부 서드 파티 광고 소스는 해당 소스에서 광고를 로드하고 표시하려면 SDK 및 GMA SDK별 어댑터가 필요합니다. 이 오류는 GMA SDK에서 서드 파티 어댑터 또는 SDK를 찾을 수 없음을 의미합니다. |
SDK 어댑터를 올바르게 설치했는지 확인합니다. Android 및 iOS에 대해 자세히 알아보세요. |
| 초기화되지 않음 | 각 서드 파티 광고 소스 SDK 어댑터는 필요한 매개변수를 사용하여 코드베이스에서 명시적으로 초기화해야 합니다. |
통합 가이드를 올바르게 따랐는지 확인합니다. Android 및 iOS에 대해 자세히 알아보세요. 특정 초기화 오류는 서드 파티 광고 소스 설명서를 참고하세요. |
입찰 광고 소스 문제 파악하기
- Android: 20.2.0 이상
- iOS: 8.5.0 이상
SDK 요청 로그에서 서드 파티 입찰 소스에 대한 세부정보를 검토할 때 다음 문제 중 하나가 발생할 수 있습니다.
| 문제 | 의미 | 취할 수 있는 조치 |
|---|---|---|
| SDK 신호를 찾을 수 없음 | 일부 광고 소스에서 입찰을 사용하려면 SDK 및 어댑터를 설치하고 올바르게 구성해야 할 수 있습니다. | Android 및 iOS에 대한 SDK 요구사항을 올바르게 준수했는지 확인합니다. |
| 사용자 동의 없음 | 사용자가 필요한 동의를 제공하지 않으면 광고 소스에서 입찰 요청을 받지 못할 수 있습니다. 이는 정상적인 동작일 수 있습니다. | Ad Manager 정책에서 GDPR과 같은 동의 도구를 구현하는 방법을 자세히 알아보세요. |
| 광고가 반환되지 않음 |
광고 소스에서 광고 요청에 대해 입찰하지 않기로 결정했거나 입찰하지 못할 수 있습니다.
|
자세한 내용은 광고 소스를 확인하세요.
서드 파티 입찰 소스가 입찰 중이 아닌 경우 수집 중인 신호에 문제가 있을 수 있습니다.
|
광고 요청당 서드 파티 입찰 매개변수 문제 보기
서드 파티 파트너 세부정보 검토할 때 다음 오류 중 하나가 발생할 수 있습니다. 아래 표에서 오류의 의미와 권장되는 다음 단계를 확인하세요.
| 오류 메시지 | 의미 | 취할 수 있는 조치 |
|---|---|---|
NO_ERROR |
오류가 없습니다. | 별도의 조치를 취하지 않아도 됩니다. |
ADAPTER_CREATION_FAILURE |
서드 파티 SDK 어댑터를 찾을 수 없거나 초기화하지 않았습니다. | 어댑터와 서드 파티 SDK를 올바르게 가져왔는지 확인합니다(Android 및 iOS). |
SIGNAL_COLLECTION_FAILURE |
신호 수집 중에 서드 파티 SDK 어댑터가 오류를 반환했습니다. 이는 SDK 신호를 찾을 수 없거나 시간이 초과되었음을 의미할 수 있습니다. |
광고 검사기에서 제공된 오류 설명을 검토하여 문제의 원인을 파악합니다. 계정에서 광고 단위를 올바르게 매핑했는지 확인합니다. 서드 파티 광고 소스 SDK가 초기화되었는지 확인합니다. 그렇지 않으면 서드 파티 광고 소스의 설명서를 참고하세요. |
SIGNAL_COLLECTION_TIMEOUT |
서드 파티 SDK 어댑터의 신호 수집 시간이 초과되었습니다. |
서드파티 광고 소스의 SDK가 초기화되었는지 확인합니다. 그렇지 않으면 서드 파티 광고 소스의 설명서를 참고하세요. |
UNKNOWN_ERROR |
예상치 못한 오류를 나타냅니다. |
알 수 없는 오류는 정확한 원인을 파악할 수 없음을 의미합니다. 다음과 같은 일반적인 문제를 확인할 수 있습니다.
그렇지 않으면 서드 파티 광고 소스의 설명서를 참고하세요. |
ADAPTER_PROTOCOL_ CONFORMANCE_FAILURE |
이는 서드 파티 SDK 어댑터가 지원되지 않거나 어댑터의 구성에 문제가 있음을 의미합니다. |
어댑터와 서드 파티 SDK를 올바르게 가져왔는지 확인합니다(iOS). 이 오류는 iOS용 어댑터의 경우에만 표시됩니다. |
개인 정보 보호 문제 이해하기
광고 검사기의 '개인 정보 보호' 섹션에 다음 오류가 표시될 수 있습니다. 이 오류의 의미와 해결 방법을 검토하세요.
| 오류 메시지 | 의미 | 취할 수 있는 조치 |
|---|---|---|
| 개인 정보 보호 세부정보를 찾을 수 없음 앱/요청의 개인 정보 보호 세부정보를 보려면 최신 Google 모바일 광고 SDK로 업데이트하세요. |
이 오류는 앱/요청의 SDK 버전이 너무 오래되어 광고 검사기에서 개인 정보 보호 신호를 표시할 수 없는 경우 발생할 수 있습니다. | 다음을 지원하는 최소 Google 모바일 광고 SDK 버전으로 업데이트합니다.
|
예상치 않게 누락된 값 문제 해결
문제를 해결할 때 값이 하이픈(–)으로만 표시되는 경우가 있으면 신호가 누락된 것입니다. Google 인증 CMP와 통합했는지, 테스트 기기에서 필요한 지리적 위치를 보고하고 있는지 확인해야 할 수도 있습니다.
Google 인증 CMP 사용
유럽 경제 지역(EEA), 영국, 스위스의 사용자에게 광고를 게재할 때는 Google의 인증을 거쳐 IAB의 투명성 및 동의 프레임워크(TCF)와 통합된 동의 관리 플랫폼(CMP)을 사용해야 합니다.
GDPR 적용 지역 확인
광고 검사기에서 동의 워크플로를 완전히 테스트하고 개인 정보 보호 관련 신호를 확인하려면 EEA, 영국 또는 스위스에 거주하거나 기기가 EEA에 있는 것처럼 앱 동작을 테스트하도록 CMP를 구성해야 합니다. 이 작업이 완료되면 광고 검사기 개인 정보 보호 UI의 'GDPR 적용' 값이 'true'로 표시됩니다.
