광고 단위 테스트
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
광고 검사기는 다음 테스트를 지원합니다.
- 문맥 내 테스트: 앱의 광고 단위에서 광고를 로드합니다. 광고 검사기를 열어 광고 단위에서 이루어진 요청에 대한 세부정보를 볼 수 있습니다.
- 문맥 외 테스트: 앱의 UI로 이동하지 않고 광고 검사기에서 직접 광고 단위를 테스트합니다. 한 번에 여러 광고 단위를 테스트하고, 테스트 광고 요청을 비동기식으로 로드하고 확인하며, 단일 광고 소스 테스트를 실행할 수 있습니다.
컨텍스트 외부 테스트를 실행할 때 요청에는 아동 대상 서비스 구성, 맞춤 타겟팅, 네트워크 추가 기능, 다양한 크기 등 앱의 UI에서 실행할 매개변수가 포함되지 않습니다. 이러한 요청의 제한사항으로 인해 앱의 UI에서 컨텍스트 내 테스트를 사용하는 것이 좋습니다.
기본 요건
계속하기 전에 다음을 수행하세요.
- 초기 기본 요건의 모든 항목을 완료하여 Ad Manager 계정을 만들고, 테스트 기기를 설정하고, Google 모바일 광고 SDK를 초기화하고, 최신 버전을 설치합니다.
- 광고 검사기 실행
테스트 광고 요청
광고 단위가 여러 광고 형식을 지원할 수 있지만 광고 검사기에서는 테스트할 형식을 선택할 수 없으며 기본적으로 마지막으로 요청된 형식이 사용됩니다.
광고 인스펙터에서 테스트 광고를 요청하려면 다음 단계를 완료하세요. 자세한 내용은 광고 검사기 (베타)를 참고하세요.
관련 맥락:
- 테스트 기기에서 앱의 UI로 이동하여 광고를 로드합니다.
- 광고 검사기를 엽니다. 광고 단위 탭에서 광고를 로드한 광고 단위를 찾습니다.
- SDK 요청 로그에서 요청한 테스트 광고에 대한 세부정보를 확인합니다.
Out-of-context:
- 광고 단위 탭에서 광고 단위를 탭하고 테스트 광고 요청을 클릭합니다.
- SDK 요청 로그에서 요청한 테스트 광고에 대한 세부정보를 확인합니다.
광고 단위 형식에 알 수 없음이 표시되면 테스트 광고 요청이 회색으로 표시됩니다. 단일 광고 단위에 여러 형식을 요청하면 광고 검사기에서 마지막 광고 단위를 사용합니다.
단일 광고 소스 테스트
광고 검사기는 단일 입찰 또는 폭포식 구조 광고 소스의 광고만 게재되도록 내 앱의 광고 요청을 제한할 수 있습니다. 이 방식을 사용하면 서드 파티 어댑터와 올바르게 통합되었는지, 광고 소스가 예상대로 게재되는지 확인할 수 있습니다.
단일 광고 소스를 테스트하려면 다음 단계를 완료하세요.
광고 검사기에서 단일 광고 소스 테스트 전환 스위치를 클릭합니다. 단일 광고 소스 테스트 대화상자가 표시됩니다.
테스트할 광고 소스를 선택합니다. 그런 다음 앱 강제 다시 시작 페이지가 표시됩니다.
단일 광고 소스 테스트 설정은 나중에 하는 광고 요청에 적용됩니다.
이 테스트는 해당 세션에서 이전에 캐시된 광고에는 적용되지 않습니다.
단일 광고 소스 테스트를 적용할 때 앱을 강제로 다시 시작하는 것이 좋습니다. 이 방법을 사용하면 요청을 수신하도록 선택한 광고 소스 대신 표시될 수 있는 캐시된 광고가 무효화됩니다.
앱을 다시 시작한 후에는 모든 광고 단위 게재위치에서 선택된 광고 소스의 광고를 게재하려고 시도합니다. 단일 광고 소스 테스트가 진행 중일 때 광고 검사기를 실행하면 테스트가 진행되고 있는 광고 소스가 다음과 같이 표시됩니다.
단일 광고 소스 테스트 모드에서는 선택한 광고 소스가 입찰 또는 폭포식 구조에 대해 구성되었는지에 관계없이 모든 광고 요청에서 이러한 광고 소스를 게재하려고 시도합니다. 테스트 중인 광고 소스가 광고 단위의 입찰 또는 폭포식 구조에 설정되어 있지 않으면 다음 오류 메시지가 표시됩니다.
Ad Unit has no applicable adapter for single ad source testing on network: AD_SOURCE_ADAPTER_CLASS_NAME
단일 광고 소스 테스트를 시작한 후 광고 소스에서 광고 요청을 처리했는지 확인하려면 광고 단위를 탭하여 SDK 요청 로그를 확인하세요. 광고 소스에서 광고를 로드하지 못하면 해당 오류를 설명하는 오류 메시지가 표시됩니다(예: Adapter failed to initialize).
선택한 광고 소스의 여러 인스턴스를 폭포식 구조에 추가한 경우 광고 소스에 대한 각 호출 인스턴스가 표시됩니다. 이 프로세스는 광고가 게재되거나 광고가 게재되지 않고 폭포식 구조가 종료될 때까지 렌더링됩니다.
단일 광고 소스 테스트 중지하기
테스트를 중지하려면 다음 단계를 완료하세요.
- 광고 검사기에서 단일 광고 소스 테스트 전환 스위치를 클릭하여 사용 중지합니다. 단일 광고 소스 테스트를 중지하시겠습니까? 대화상자가 표시됩니다.
테스트 중지를 탭합니다.
성공하면 앱 강제 다시 시작 위에 확인 메시지가 표시됩니다.
테스트한 광고 소스에 대해 캐시된 광고를 취소하려면 테스트를 중지한 후 앱을 강제로 다시 시작하는 것이 좋습니다.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-31(UTC)
[null,null,["최종 업데이트: 2025-08-31(UTC)"],[],[],null,["Select platform: [Android](/ad-manager/mobile-ads-sdk/android/ad-inspector/test-ad-units \"View this page for the Android platform docs.\") [iOS](/ad-manager/mobile-ads-sdk/ios/ad-inspector/test-ad-units \"View this page for the iOS platform docs.\") [Unity](/ad-manager/mobile-ads-sdk/unity/ad-inspector/test-ad-units \"View this page for the Unity platform docs.\") [Flutter](/ad-manager/mobile-ads-sdk/flutter/ad-inspector/test-ad-units \"View this page for the Flutter platform docs.\")\n\n\u003cbr /\u003e\n\nAd inspector supports the following tests:\n\n- **In-context testing**: load ads from the ad units in your app. You can open ad inspector to view details on requests made from ad units.\n- **Out-of-context testing**: test your ad unit directly in ad inspector without navigating to your app's UI. You can test multiple ad units at once, asynchronously load and view your test ad requests, and perform single ad source tests.\n\nWhen running an out-of-context test, your requests don't carry the parameters\nto run in your app's UI, including child-directed treatment configuration,\ncustom targeting, network extras, and different sizes. Due to the limitation of\nthese requests, we recommend you use in-context testing in your app's UI.\n\nPrerequisites\n\nBefore you continue, do the following:\n\n- Complete all items in the initial [Prerequisites](/ad-manager/mobile-ads-sdk/android/ad-inspector#prerequisites) to create an Ad Manager account, set your test device, initialize Google Mobile Ads SDK, and install the latest version.\n- [Launch ad inspector](/ad-manager/mobile-ads-sdk/android/ad-inspector/launch-ad-inspector).\n\nRequest a test ad\n\nThough your ad unit might support multiple ad formats, ad inspector doesn't let\nyou select which format to test, and defaults to the last requested format.\n\nTo request a test ad in ad inspector, complete the following steps. For more\ndetails, see\n\n[Ad inspector (Beta)](//support.google.com/admanager/answer/7180401#ad-inspector).\n\n\n- **In-context**:\n\n 1. On a test device, navigate to your app's UI and load an ad.\n 2. Open ad inspector. In the **Ad unit** tab, find the ad unit where you loaded the ad.\n 3. In **SDK request log**, view details on your requested test ad.\n- **Out-of-context**:\n\n 1. In the **Ad unit** tab, tap on your ad unit and click **Request test ad**.\n 2. In **SDK request log**, view details on your requested test ad.\n\n| **Note:** To request a test ad, [initialize the Google Mobile Ads SDK](/ad-manager/mobile-ads-sdk/android/quick-start#initialize_the_mobile_ads_sdk) with an `Activity` context.\n\nIf the ad unit format shows **Unknown** , you see **Request test ad** greyed\nout. If you request multiple formats for\na single ad unit, ad inspector uses the last ad unit.\n\n\nTest a single ad source\n\nAd inspector can restrict ad requests in your app to serve ads from a single\nbidding or waterfall ad source. This approach lets you verify that you've\ncorrectly integrated with the third-party adapter, and the ad source serves\nas expected.\n\nTo test a single ad source, complete the following steps:\n\n1. In **Ad inspector** , click the **Single ad source test** toggle. A\n **Single ad source test** dialog appears:\n\n \u003cbr /\u003e\n\n\n2. Select an ad source to test. Afterwards, you receive the\n **Force restart app** page:\n\nThe single ad source test setting applies to any future ad requests you make.\nThis test doesn't apply to previously cached ads in that session.\nWe recommend you to force restarting your app when applying a single ad source\ntest. This approach invalidates cached ads that might display instead of\nyour chosen ad source receiving a request.\n\nAfter restarting your app, all ad unit placements attempt to show an ad from the\nselected ad source. Launching ad inspector when a single ad source test is\nactive shows the active test ad source:\n\nIn single ad source test mode, all ad requests attempt to fill with the\nselected ad source, regardless of whether that ad source was configured for\nbidding or waterfall. If the ad source you're testing is not set up for bidding\nor waterfall for the ad unit, you receive the following error message: \n\n Ad Unit has no applicable adapter for single ad source testing on network: \u003cvar translate=\"no\"\u003eAD_SOURCE_ADAPTER_CLASS_NAME\u003c/var\u003e\n\nTo verify whether the ad source filled the ad requests after you start a single\nad source test, tap an ad unit to view the SDK request log. If the ad source\nfailed to load an ad, an error message appears describing the error, such\nas `Adapter failed to initialize`.\n\nIf you've added multiple instances of the selected ad source to a waterfall, you\nsee each call instance to the ad source. This process renders until the ad is\neither filled or the waterfall ends without a fill.\n\nStop a single ad source test\n\nTo stop the test, complete the following steps:\n\n1. In **Ad inspector** , click off the **Single ad source test** toggle. The **Stop single ad source test?** dialog appears.\n2. Tap **Stop test**.\n\n\n If successful, a confirmation message appears over **Force restart app**:\n\nTo revoke cached ads for the tested ad source, we recommend you to force\nrestart the app after stopping the test."]]
