기술 자료

Unity Ads Monetization


Unity API 참조

Unity Ads Monetization


SDK의 show 기능 오류 문제를 해결합니다.

광고 요청 중 광고를 표시할 때 발생할 수 있는 일반적인 문제를 해결합니다.
읽는 시간 1분최근 업데이트: 한 달 전

이러한 오류는 Unity Ads SDK에서 광고 콘텐츠 가져오지 못하여 표시할 때 발생합니다. 광고를 성공적으로 표시할 수 없는 경우 광고 요청을 완료할 수 없습니다. 이 가이드를 사용하면 광고를 표시할 때 발생할 수 있는 문제를 빠르게 식별 수정할 수 있습니다.

Symptoms

Unity Ads SDK를 사용하여 광고를 표시하려고 하면 다음 오류 메시지 반환됩니다.
[52200] Unity Ads SDK 광고 표시 실패: 광고가 만료되었습니다. 새 광고를 로드합니다.
이 오류 메시지 show 요청이 이루어지기 전에 광고가 만료되었음을 나타냅니다.

Causes

이러한 오류가 발생하는 일반적인 이유는 광고 로딩과 표시 사이에 시간이 너무 오래 걸리기 때문입니다.

Resolution

이 문제를 결정하려면
onAdExpired
메서드가 호출된 후 새 광고를 로드합니다.
참고
향후 이 오류를 방지하기 위해 폴백 로직을 추가하는 것이 좋습니다. 광고가 이 오류와 함께 실패하면 새 광고 로드를 자동으로 트리거합니다.

Symptoms

Unity Ads SDK를 사용하여 광고를 표시하려고 하면 다음 오류 메시지 반환됩니다.
[52201] Unity Ads SDK 광고 표시 실패: 이미 광고가 표시되고 있습니다. 새 광고를 표시하기 전에 현재 광고가 종료될 때까지 기다립니다.
이 오류 메시지 다른 인터스티셜 광고 광고나 보상형 광고 광고가 이미 표시 중임을 나타냅니다.

Causes

이 오류의 일반적인 원인은 다음과 같습니다.
  • 앱이 show 메서드를 두 번 빠르게 연속적으로 호출합니다. 예를 들어 "Watch ad" 버튼을 더블 클릭하면 두 개의 show 요청이 트리거됩니다.
  • 앱이 이전의 완료 콜백 작동하기 전에 다른 광고 쇼를 트리거함
  • 두 개의 서로 다른 광고를 병렬 표시하려고 시도(예: 인터스티셜 광고 광고가 여전히 표시되는 동안 보상형 광고 광고를 표시하려고 시도)

Resolution

이 문제를 결정 인터스티셜 광고 광고와 보상형 광고 광고에 한 번에 하나의 광고만 표시되도록 해야 합니다.
참고
향후 이 오류를 방지하기 위해 폴백 로직을 추가하는 것이 좋습니다. show 메서드를 다시 호출하기 전에 현재 광고가 종료되고 해당 콜백 작동할 때까지 기다립니다.

Symptoms

Unity Ads SDK를 사용하여 광고를 표시하려고 하면 다음 오류 메시지 반환됩니다.
[52202] Unity Ads SDK 광고 표시 실패: 내부 오류가 발생했습니다.
이 오류 메시지 광고를 표시하려고 할 때 Unity Ads SDK에 예기치 않은 내부 오류가 발생했음을 나타냅니다.

Causes

이 오류의 일반적인 원인은 다음과 같습니다.
  • 렌더링 실패
  • 누락된 소재
  • 손상된 광고 데이터

Resolution

이 문제를 결정 SDK가 완전히 초기화되고 최신 상태인지 확인한 다음 새 광고를 다시 로드하고 표시해 보십시오.
오류가 지속되면 자세한 로그를 캡처하고 백엔드 검토를 위해 Unity 지원과 공유하십시오.