SDK 통합 문제 해결

다음 방법 중 하나로 통합이 성공했는지 확인할 수 있습니다.

• 데모 광고 단위를 사용하여 광고를 로드하고 광고가 클릭에 반응하는지 확인합니다.
• SDK의 내장 분석기 또는 네이티브 콘솔 도구를 사용합니다.
• 네이티브 광고의 경우 잘못된 통합 표시기를 활성화하여 빨간색으로 변하는지 확인할 수 있습니다.

통합 테스트에 대한 자세한 내용은 Yandex Mobile Ads SDK 섹션을 참조하세요.

• Android
• iOS
• Unity
• Flutter
• React Native

다음을 확인하세요.

• 종속성이 올바르게 추가되었는지 확인합니다.
• 라이브러리가 초기화되었는지 확인합니다.

통합 디버깅 모드도 사용할 수 있습니다.

다음과 같은 이유로 통합이 잘못되었을 수 있습니다.

1. 어댑터가 연결되지 않았거나 잘못 연결되었습니다. 타사 중재 플랫폼에 연결하는 방법에 대한 지침을 참조하세요.

   • Android
   • iOS
   • Unity

2. Unity 앱에 Unity 플러그인이 통합되지 않았습니다. 플러그인 통합에 대한 가이드를 참조하세요.

3. 광고 단위 ID가 Yandex Advertising Network 인터페이스 또는 타사 중재 계정에 잘못 지정되었습니다. 모든 계정에서 동일한 광고 단위 ID를 사용하고 있는지 확인하세요.

4. Yandex Advertising Network 인터페이스와 타사 중재 계정에 지정된 하한값이 일치하지 않습니다. 모든 계정에서 동일한 하한값을 사용하고 있는지 확인하세요.

이를 해결하려면 대상 API 수준을 버전 30으로 다운그레이드하세요. 자세한 내용은 이 가이드를 참조하세요.

그러나 Google이 오래된 대상 API 수준 버전의 앱 업데이트 릴리스에 제한을 두기 때문에 대상 API 수준 버전 31로 업그레이드하는 것이 좋습니다. 자세한 내용은 이 문서를 참조하세요.

이를 해결하려면, 앱의 android/build.gradle파일에 allprojects 아래의 코드를 추가하세요.

allprojects {
    repositories {
	// ...
    }

    // 이는 react-native 종속성 해결 문제를 수정합니다
    configurations.all {
        resolutionStrategy.dependencySubstitution {
            substitute module("com.facebook.react:react-android") using module("com.facebook.react:react-native:+")
        }
    }
}

이는 ProGuard가 빌드 시 조작 및 재배치를 수행하기 때문에 발생할 가능성이 높습니다. 이 오류는 -keepclasseswithmembernames 설정이 proguard config 파일에서 활성화된 경우 발생합니다. 이 코드를 주석 처리하거나 문자열을 삭제하세요.

이 오류는 리소스가 Podfile에서 잘못 지정된 경우 발생할 수 있습니다. 자세한 내용은 이 가이드를 참조하세요.

오류가 계속되면 지원팀에 문의하세요.

지원팀 문의

Provided block ID doesn't exist 메시지는 광고 요청 후에 나타나며, Yandex Advertising Network 인터페이스에 광고 단위가 생성되었음에도 불구하고 발생합니다.

앱의 요청에 지정된 광고 단위가 Yandex Advertising Network 인터페이스의 유효한 광고 단위인지 확인하세요.

이 오류는 시스템이 광고를 선택할 수 없음을 나타냅니다. 새로운 일치하지 않는 장치에 대한 테스트 중에 발생할 수 있습니다. 시스템이 이러한 장치에 대한 정보를 수집하고 Crypta가 이를 가져오는 데 시간이 걸리기 때문입니다. 이 과정이 완료되면 광고 선택이 시작됩니다. 이 오류는 다음과 같은 이유로도 발생할 수 있습니다.

1. 광고 단위에 설정된 CPM 하한선이 너무 높습니다.
2. 광고 단위가 보관되었습니다.
3. 사용 중인 중재가 러시아에서의 광고를 지원하지 않습니다.
4. Yandex Advertising Network 인터페이스의 앱 BundleID가 광고가 요청된 BundleID와 일치하지 않습니다.

오류가 계속되면 지원팀에 문의하세요.

지원팀 문의

이 오류는 요청 처리에 시간이 너무 오래 걸리는 경우 발생할 수 있습니다. 지원팀에 오류 기록을 제공하여 문의하세요.

지원팀 문의

전달된 AdUnitID, 요청 매개변수 및 배너 크기가 올바른지 확인하는 것이 좋습니다. 코드 샘플:

• Android
• iOS

가시성 설정에 android:visibility="gone"을 적용하고 있는 것일 수 있습니다. 수동으로 또는 코드를 통해 android:visibility="visible"을 설정하세요.

예, 가능합니다. 지원팀이나 개인 매니저에게 문의하세요.

지원팀 문의

메인 이미지의 경우 중앙을 기준으로 최대 25%까지 자를 수 있습니다. 아이콘은 확대하거나 자를 수 없지만, 비율 변경 없이 축소할 수 있습니다. 자세한 내용은 네이티브 광고를 참조하세요.

기본적으로 네이티브 광고 단위에는 텍스트 및 이미지 광고만 제공됩니다. 네이티브 광고 단위에 동영상 광고와 디스플레이 광고를 활성화하려면 지원팀이나 개인 매니저에게 문의하세요.

지원팀 문의

광고 단위의 필 레이트(fill rate)가 낮은 이유는 CPM 하한선, 카테고리 또는 브랜드 차단, 또는 기술적 문제 때문일 수 있습니다. 필 레이트(fill rate)를 높이려면 문제의 원인을 파악하고 해결 조치를 취하세요.

광고의 효과를 높이는 방법에 대한 자세한 내용은 도움말을 참조하세요.

Charles는 컴퓨터에서 실행되는 프록시 서버로, 연결된 장치의 HTTP 및 HTTPS 트래픽을 기록할 수 있도록 합니다. 기록된 세션은 요청된 광고 단위의 데이터, 배치 매개변수, 제공된 배너 정보, 장치의 기술 사양을 포함하고 있어 지원팀이 광고 로딩 및 표시와 관련된 문제를 신속하게 해결하는 데 도움이 됩니다.

Charles 설치

1. 공식 사이트에서 Charles를 다운로드하여 컴퓨터에 설치합니다.
2. 앱을 처음 실행할 때 네트워크 설정을 자동으로 구성하는 것을 제안하면, Grant Privileges를 클릭하세요.
3. 앱은 30일 무료 체험판을 제공합니다. 라이선스 키가 있는 경우, Charles 메뉴에서 Help → Register Charles를 선택하고 앱을 등록합니다.

앱 사용에 대한 자세한 정보는 Charles 문서를 참조하세요.

프록시 구성

모바일 장치의 트래픽을 기록하려면:

1. Charles 메뉴에서 Proxy → SSL Proxying Settings를 선택합니다.
2. Enable SSL Proxying 옵션을 활성화합니다.
3. Include Location을 아래에서 Add를 클릭하고 Host 필드에 별표를 입력합니다. 변경 사항을 저장합니다.
4. Charles 메뉴에서 Help → SSL Proxying → Install Root Certificate on a Mobile Device or Remote Browser를 선택합니다. 이후, Charles는 컴퓨터의 IP 주소와 기본 포트 8888에 해당하는 프록시 서버의 IP 주소 및 포트를 표시해야 합니다.
5. Charles를 다시 시작합니다.
6. 모바일 장치를 컴퓨터와 동일한 Wi-Fi 네트워크에 연결합니다. 네트워크 설정으로 이동하여 수동 프록시 설정을 선택하고 프록시 서버의 IP 주소와 포트를 입력하세요.

인증서 설치

HTTPS 트래픽을 기록하려면 모바일 장치에 Charles 루트 SSL 인증서를 설치하세요. 자세한 내용은 Charles 문서에서 확인하세요.

세션 기록

트래픽 기록을 시작하거나 중지하려면 Charles 도구 모음에서 /을 클릭하세요. 기록이 진행 중일 때 버튼은 와 같이 보입니다.

광고를 요청하는 앱에서 화면을 새로 고침하세요. 세션에 광고 다운로드 URL( mobile.yandexadexchange.net/v4/ad)이 나타나는지 확인하세요. Charles 메뉴에서 File → Save Session As... 를 선택하고 .chls 확장자로 파일을 저장하세요.