Google 양방향 미디어 광고 SDK FAQ
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
- 일부 형식에 대해 광고가 표시되지 않는 이유는 무엇인가요?
-
테스트 광고 태그는 유효한 요청에 대해 항상 광고를 반환하도록 설정됩니다. 이것은
이는 통합을 용이하게 하고 플레이어가 여러 동영상 사이에
광고를 요청하고 렌더링합니다. 하지만 사이트, 계정 또는 광고 단위에서 모든 형식의 광고를 사용할 수 있는 것은 아닙니다. 테스트 태그에는 통합이 제대로 작동하지만 자체 태그에는 작동하지 않는 경우 다음 중 하나가 원인일 수 있습니다.
- 지원되지 않는 형식의 동영상을 환경에 게재하고 있습니다. 예를 들어 iOS 또는 Android에 HTML5 광고만 게재하는 경우
- Ad Manager를 사용하는 경우 현재 게시자 ID에 게시자 ID를 타겟팅하는 광고가 없을 수 있습니다. 또한 Ad Manager에서 관련 광고 및 광고 소재를 승인했는지 확인합니다.
- 애드센스를 사용하는 경우 사이트 또는 테스트 페이지의 타겟팅 기준에 활성 광고가 없을 수 있습니다. 가장 일반적인 원인은
크롤링되지 않은 비공개 웹사이트
- Ad Exchange 네트워크 파트너 관리를 사용 중이고
descriptionURL
가 설정되어 있지 않거나 소유 또는 운영 중인 도메인 관리 목록에 없는 경우 광고가 게재되지 않습니다.
- Ad Exchange 동영상에 정의된 minCPM 기준점을 확인합니다. 가
CPM이 상당히 높으면 유효노출률이 매우 낮아질 수 있습니다. 이 문제를 해결하려면 다음 중 하나를 시도하세요.
minCPM을 삭제하거나 광고 요청에서 광고 단위 매개변수를 제거합니다.
(예:slotname)을 사용하여 유효노출률에 영향을 미치는지 확인할 수 있습니다.
- 좋은
descriptionUrl
은 어떤 모습일까요?
-
최대의 효과를 내려면
descriptionUrl
가리키는 대상은 단어나 구문의 모음이 아니라
콘텐츠와 해당 콘텐츠를 제공하는 데 있어 귀하의 역할을 실제로 설명하는 1~3개의 단락이어야 합니다.
과거에 효과를 보였던 한 가지 방법은 사전 정의된 블록에서 descriptionUrl
페이지 콘텐츠를 동적으로 병합하는 것입니다.
예를 들어 콘텐츠에 관한 문장 몇 개, 사이트 제품에 관한 문장 몇 개, 각 애드센스 채널(예: '엔터테인먼트' 또는 '스포츠')과 연결된 사전 정의된 스니펫 몇 개를 작성합니다. 따라서 각 콘텐츠에는 일반적인 정보(예: 장르 설명자)와 구체적인 정보(콘텐츠에 관한 직접적인 콘텐츠)를 모두 제공하는 상당히 고유한 descriptionUrl
가 연결되어 있습니다.
이 메타데이터 HTML은 간단해야 합니다. 예를 들면 다음과 같습니다.
<html>
<head>
<title>Domain.com - Your tag line here!</title>
</head>
<body>
<h1>Descriptions</h1>
<h2>About this Content</h2>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. ...</p>
<h2>About Domain.com</h2>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. ...</p>
</body>
</html>
- '광고 응답에 유효한 광고 유형이 포함되지 않음' 오류가 발생하는 이유는 무엇인가요?
- 이 오류는 일반적으로
특정
publisherId
(지정된 기간) 이 조건은 하루 중 시간에 따라 다르거나 캠페인이 시작되고 종료되는 며칠 동안 달라질 수 있습니다.
타겟팅하려는 광고가 만료되지 않았는지, 광고가 만료되지 않았는지
광고 타겟팅 기준이 올바른지 확인합니다.
광고가 올바르게 요청, 수신 및 렌더링되는 경우
publisherId
테스트에서는 이러한 광고가
광고가 다음과 같은 경우 실시간 publisherId
를 사용하여 올바르게 처리됨
있습니다.
- 테스트에 사용할 수 있는 Ad Manager 동영상 광고 태그가 있나요?
- 샘플 태그는 샘플 태그 페이지에서 확인할 수 있습니다.
adSlotWidth
과 adSlotHeight
를 동일하게 설정해야 하나요?
값을 sz
로 설정해야 하나요?
- 반드시 그런 것은 아닙니다.
adSlotWidth
및 adSlotHeight
광고가 표시하려는 영역의 너비/높이로 설정되어야 합니다.
채워야 합니다. 애드센스에서 해당 공간에 맞는 광고를 결정하는 데 사용됩니다. Ad Manager 광고 태그의 sz
키-값 쌍은 타겟팅 매개변수이며 반드시 게재되는 광고 소재에 영향을 미치지는 않습니다(자세한 내용은 아래 참고).
- 데모 광고 태그는 멋져 보이지만 내 광고 태그로 바꾸면 광고가 표시되지 않습니다.
-
사용 중인 광고 태그에 트래피킹되고 있는 것이 있는지
있습니다. 가장 쉬운 방법은 HTTP 트래픽을 확인하는 것입니다. HTML 앵커 블록 내에 1x1픽셀 grey.gif 이미지가 반환되면 Ad Manager에서 타겟팅을 확인해야 합니다.
- 동일한 태그를 사용하여 광고를 두 번 이상 요청하고 싶지만 처음 사용할 때만 광고가 표시됨
요청을 수행합니다. 이 문제를 해결하려면 어떻게 해야 하나요?
-
광고를 두 번 이상 요청하는 경우 광고 서버에 이러한 요청이 실수로 인한 중복이 아닌 적법한 요청임을 알려야 합니다. SDK
두 가지 빠른 API 호출로 이 작업을 수행합니다.
<ph type="x-smartling-placeholder">
</ph>
AdsManager
인스턴스에서 destroy()
를 호출합니다.
이렇게 하면 아래에서 contentComplete()
를 호출할 때 포스트롤이 재생되지 않습니다. 새로운 AdsManager
이(가) 제공됩니다
요청을 수행합니다.
AdsLoader
에서 contentComplete()
에 전화 걸기
인스턴스를 만들 수 있습니다 이렇게 하면 SDK가 재설정되어 새 광고 요청이
중복됩니다.
를 통해 개인정보처리방침을 정의할 수 있습니다.
위의 두 가지 호출을 한 후 다음에서 requestAds()
를 호출할 수 있습니다.
AdsLoader
인스턴스에 추가하여
새 동영상입니다.
- IMA SDK를 사용하여 오버레이 및 전체 슬롯 애드센스 광고를 요청하려면 어떻게 해야 하나요?
-
SDK를 사용하여 애드센스 광고를 요청하려면 먼저 애드센스
광고 태그 자세한 내용은 애드센스
동영상 페이지를 참고하세요. 태그를 만든 후에는 오버레이 또는 전체 슬롯 광고 요청을 하려면 다음 단계를 따르세요.
오버레이 광고
AdsRequest
에서 ViewModes를 다음과 같이 설정합니다.
NORMAL
- 광고 태그에
overlay=1
매개변수를 추가합니다.
전체 슬롯 광고
AdsRequest
에서 ViewModes를 다음과 같이 설정합니다.
FULLSCREEN
- 광고 태그에
overlay=0
매개변수를 추가합니다.
- '잘못된 클릭연결 URL' 메시지가 표시됩니다. 오류가 발생합니다. 원인이 무엇일까요?
-
이 오류가 발생하는 가장 일반적인 원인은 부적절하게 이스케이프된 클릭연결입니다.
URL입니다. 이 오류가 표시되면 VAST 응답에서 클릭연결 URL이 제대로 이스케이프 처리되었는지 확인하세요.
- Android 및 iOS SDK에서 전체 동영상 광고를 클릭 가능하도록 만들 수 있는 방법이 있나요?
- 전체 동영상 클릭 추적과 관련하여, 동영상을 탭하면 동영상이 일시중지되거나 플레이어 컨트롤이 표시되는 모바일 동영상의 표준 시청자 환경이 등장했습니다. 사용자가 플레이어 컨트롤에 액세스하려고 할 때 의도치 않게 광고를 클릭하는 것을 방지하기 위해 IMA는 자세히 알아보기 버튼을 사용하여 사용자가 광고를 클릭하고 광고 중인 제품에 대해 자세히 알아볼 수 있도록 합니다.
- 'VAST 문서가 비어 있습니다'라고 표시되는 이유는 무엇인가요? 오류가 있나요?
- 이 오류는 광고 태그가 빈 VAST 문서를 반환할 때 발생합니다.
광고가 제대로 게재되지 않았다는
사실을 알 수 있습니다. 계정 관리자에게 문의하기
또는 광고 서버 담당자에게 문의하여 광고 태그가 작동하지 않는 이유를 확인하세요.
- 광고 건너뛰기 상자 또는 다른 UI 요소의 크기/텍스트를 변경할 수 있나요?
- IMA SDK는 UI 요소의 레이아웃, 크기 또는 콘텐츠 변경을 지원하지 않습니다.
UI 요소에 관한 자세한 내용은
AdsManager.uiElements
를 참고하세요.
- iOS에서 광고의 볼륨을 변경할 수 없는 이유는 무엇인가요?
-
iOS에서는 볼륨을 프로그래매틱 방식으로 설정할 수 없습니다. HTML5 SDK를 사용하는 경우
adsManager.setVolume()
는 영향을 미치지 않습니다. iOS SDK는
이런 이유로 IMAAds에 볼륨 setter를 제공합니다.
- 여러 스레드를 사용하여 UI를 초기화하고 조작할 수 있나요?
-
UI의 모든 초기화는 기본 스레드에서 실행해야 합니다. 후(After)
kubectl 명령어를 구현하면
백그라운드 광고 재생.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-31(UTC)
[null,null,["최종 업데이트: 2025-08-31(UTC)"],[[["\u003cp\u003eThe test ad tags always return ads for valid requests to make integration and testing easier, however, live ads may not always be available for all ad formats, placements or targeting criteria.\u003c/p\u003e\n"],["\u003cp\u003eEnsure your \u003ccode\u003edescriptionUrl\u003c/code\u003e is set to a page on your site with 1-3 paragraphs accurately describing the content for better ad targeting.\u003c/p\u003e\n"],["\u003cp\u003eWhen requesting ads more than once using the same tag, ensure you reset the SDK by calling \u003ccode\u003edestroy()\u003c/code\u003e on \u003ccode\u003eAdsManager\u003c/code\u003e and \u003ccode\u003econtentComplete()\u003c/code\u003e on \u003ccode\u003eAdsLoader\u003c/code\u003e to avoid duplicate requests.\u003c/p\u003e\n"],["\u003cp\u003eThe "Ad response does not contain a valid ad type" error generally indicates that no ads are currently targeted to your publisher ID, time period or ad unit, ensure your ads and creatives are approved, targeted correctly and have not expired.\u003c/p\u003e\n"],["\u003cp\u003eThe IMA SDK does not allow for customization of UI elements like the "Skip Ad" button, and on iOS, programmatic volume control for ads is restricted by the operating system.\u003c/p\u003e\n"]]],[],null,["# Google Interactive Media Ads SDK FAQs\n\n- [Why am I not getting ads back for all formats?](#1)\n- [What does a good descriptionUrl look like?](#2)\n- [Why am I receiving the error \"Ad response does not contain a valid ad type\"?](#3)\n- [Do you have an Ad Manager video ad tag that I can use for testing?](#4)\n- [Should I set the adSlotWidth and adSlotHeight to the same values\n as the sz in my Ad Manager ad tag?](#5)\n- [The demo ad tag looks great, but when I switch it with my ad tag,\n no ad appears.](#7)\n- [I want to request ads using the same tag more than once, but I\n only get ads for my first request. How do I fix this?](#8)\n- [How do I request overlay and full slot AdSense ads using the IMA\n SDK?](#9)\n- [I'm getting an \"Invalid clickthrough URL\" error when I click on my\n ad. What could be the cause?](#10)\n- [In the Android and iOS SDKs, is there a way to make the entire video\n ad clickable?](#11)\n- [Why do I see a \"VAST Document Empty\" error?](#12)\n- [Can I change the size/text of the \"Skip Ad\" box or other UI elements?](#13)\n- [Why can't I change an ad's volume on iOS?](#16)\n- [Can I use multiple threads to initialize and manipulate the UI?](#18)\n\n*** ** * ** ***\n\nWhy am I not getting ads back for all formats?\n:\n The test ad tags are set up to always return ads for valid requests. This is\n meant to facilitate integration and make it easier to test how your player\n requests and renders ads. However, ads are not always available in every\n format for your site, account, or ad unit. If your integration is working\n properly for the test tag but not for your own tag, the cause may be one of\n the following:\n\n - You're serving videos of an unsupported format to your environment. For example, you're serving only HTML5 ads to iOS or Android.\n - If you're using Ad Manager, your publisher ID may not have any ads targeted to it at this time. Also, ensure that you have approved the relevant ads and creatives in Ad Manager.\n - If you're using AdSense, the targeting criteria for your site or test page may not have any active advertisements. The most common cause is the use of private, uncrawled websites.\n - If you're using Ad Exchange Network Partner Management and `descriptionURL` is not set or is not on the owned or operated domains management list, ads do not serve to this.\n - Check the *minCPM* thresholds defined in Ad Exchange Video. A fairly high CPM may result in very low fill rates. To correct this, try either removing the minCPM or removing the ad unit parameter from the ad request (i.e., slotname) to verify whether this is affecting the fill rate.\n\nWhat does a good `descriptionUrl` look like?\n:\n To be most effective, the content of the page that `descriptionUrl`\n points to shouldn't be a collection of words or phrases but rather\n 1-3 paragraphs actually describing the content and your role in providing it.\n One method that has been successful in the past is to stitch together\n `descriptionUrl` page content dynamically from predefined blocks.\n For example, a few sentences about the content, a few sentences about your\n site's offering, and then a few predefined snippets associated with each\n AdSense channel (like \"Entertainment\" or \"Sports\"). As a result, each piece of\n content has a reasonably distinct `descriptionUrl` associated with\n it that provides both general information (such as genre descriptors) as well\n as specific information (content about the content directly).\n\n This metadata HTML should be simple, for example:\n\n ```text\n \u003chtml\u003e\n \u003chead\u003e\n \u003ctitle\u003eDomain.com - Your tag line here!\u003c/title\u003e\n \u003c/head\u003e\n \u003cbody\u003e\n \u003ch1\u003eDescriptions\u003c/h1\u003e\n \u003ch2\u003eAbout this Content\u003c/h2\u003e\n \u003cp\u003eLorem ipsum dolor sit amet, consectetur adipiscing elit. ...\u003c/p\u003e\n \u003ch2\u003eAbout Domain.com\u003c/h2\u003e\n \u003cp\u003eLorem ipsum dolor sit amet, consectetur adipiscing elit. ...\u003c/p\u003e\n \u003c/body\u003e\n \u003c/html\u003e\n \n ```\n\nWhy am I receiving the error \"Ad response does not contain a valid ad type\"?\n: This error generally appears because no ads have been targeted to the\n specific `publisherId` (for the given time period). This condition\n may vary throughout the day, or over several days as campaigns begin and end.\n You should check that the ad you wish to target has not expired and that the\n ad targeting criteria are correct.\n As long as ads are properly requested, received, and rendered using\n the test `publisherId`, you can be sure that these ads are\n properly handled using your live `publisherId` when the ads are\n available.\n\nDo you have an Ad Manager video ad tag that I can use for testing?\n: Sample tags are available on the [sample tags](/interactive-media-ads/docs/sdks/ios/client-side/tags) page.\n\nShould I set the `adSlotWidth` and `adSlotHeight` to the same\nvalues as the `sz` in my Ad Manager ad tag?\n: Not necessarily. The `adSlotWidth` and `adSlotHeight`\n must be set to the width/height of the player or area you want your ads to\n fill. They are used by AdSense to determine which ads are available to fit\n into that space. The `sz` key/value pair in your Ad Manager ad tag is\n a targeting parameter and does not necessarily affect the creative served\n (more information below).\n\nThe demo ad tag looks great, but when I switch it with my ad tag, no ad appears.\n:\n Check to ensure that something is trafficked to the ad tag you are\n requesting. The easiest way to find out is to watch the HTTP traffic. If a\n **1x1 pixel grey.gif** image is returned within an HTML anchor block,\n then you need to check your targeting in Ad Manager.\n\nI want to request ads using the same tag more than once, but I only get ads for my first\nrequest. How do I fix this?\n:\n When you request ads more than once, you need to let the ad server know\n that these are legitimate requests, and not accidental duplicates. The SDK\n does this for you with two quick API calls:\n\n 1. Call `destroy()` on your `AdsManager` instance. This prevents any post-rolls from playing when you make the below call to `contentComplete()`. You get a new `AdsManager` when you make your next request.\n 2. Call `contentComplete()` on your `AdsLoader` instance. This resets the SDK so the new ad request doesn't look like a duplicate of the previous one.\n\n\n After making the two calls above, you can call `requestAds()` on\n your `AdsLoader` instance to get another set of ads to play for your\n new video.\n\nHow do I request overlay and full slot AdSense ads using the IMA SDK?\n\n: To request AdSense ads using the SDK, you need to first obtain an AdSense\n ad tag. You can learn more about that on the [AdSense\n for Video page](//support.google.com/adsense/answer/1705822). Once you have your tag, you need to take the following\n steps to make either an overlay or a full slot ad request:\n\n **Overlay ads**\n\n 1. In your `AdsRequest`, set your ViewModes to `NORMAL`.\n 2. In your ad tag, add the parameter `overlay=1`.\n\n **Full slot ads**\n\n 1. In your `AdsRequest`, set your ViewModes to `FULLSCREEN`.\n 2. In your ad tag, add the parameter `overlay=0`.\n\nI'm getting an \"Invalid clickthrough URL\" error when I click on my ad. What could be the cause?\n:\n The most common cause for this error is an improperly escaped clickthrough\n URL. If you're seeing this error, check to make sure that your clickthrough\n URL is properly escaped in your VAST response.\n\nIn the Android and iOS SDKs, is there a way to make the entire video ad clickable?\n: As far as whole-video click tracking goes, the standard viewer experience\n for mobile video that has emerged is that tapping on a video either\n pauses it or brings up the player controls. To avoid users\n unintentionally clicking on ads when they really just want access to the\n player controls IMA uses the **Learn more** button to let\n users click on an ad and learn more about the product being advertised.\n\nWhy do I see a \"VAST Document Empty\" error?\n: This error occurs when the ad tag returns an empty VAST document, indicating\n that the ad was not served properly. Talk to your account manager\n or ad server representative to see why your ad tag is not working.\n\nCan I change the size/text of the **Skip Ad** box or other UI elements?\n: The IMA SDKs do not support changing the layout, size, or content of UI elements.\n For more details on UI elements, see `AdsManager.uiElements`.\n\nWhy can't I change an ad's volume on iOS?\n:\n iOS does not allow you to set volume programmatically. If you're using the\n HTML5 SDK, `adsManager.setVolume()` has no effect. The iOS SDK does not\n provide a volume setter on the IMAAdsManager for this reason.\n\nCan I use multiple threads to initialize and manipulate the UI?\n:\n\n All initialization of the UI must be done on the main thread. After\n initialization, you can choose to implement\n [Background Ad Playback](/interactive-media-ads/docs/sdks/ios/background_ad_playback)."]]