Google 양방향 미디어 광고 SDK FAQ

일부 형식에 대해 광고가 게재되지 않는 이유는 무엇인가요?
테스트 광고 태그는 유효한 요청에 대해 항상 광고를 반환하도록 설정됩니다. 이렇게 하면 통합이 용이해지고 플레이어가 광고를 요청하고 렌더링하는 방식을 더 쉽게 테스트할 수 있습니다. 하지만 사이트, 계정 또는 광고 단위에서 모든 형식의 광고가 항상 제공되는 것은 아닙니다. 통합이 테스트 태그에서는 제대로 작동하지만 자체 태그에서는 제대로 작동하지 않는다면 다음 중 하나가 원인일 수 있습니다.
  • 지원되지 않는 형식의 동영상을 환경에 제공하고 있습니다. 예를 들어 iOS 또는 Android에 HTML5 광고만 게재합니다.
  • Ad Manager를 사용 중인 경우 현재 게시자 ID로 타겟팅된 광고가 없을 수 있습니다. 또한 Ad Manager에서 관련 광고 및 광고 소재를 승인했는지 확인하세요.
  • 애드센스를 사용 중인 경우 사이트 또는 테스트 페이지의 타겟팅 기준에 활성 광고가 없을 수 있습니다. 가장 일반적인 원인은 크롤링되지 않은 비공개 웹사이트를 사용하는 것입니다.
  • Ad Exchange 네트워크 파트너 관리를 사용 중이고 descriptionURL가 설정되어 있지 않거나 소유 또는 운영 중인 도메인 관리 목록에 없는 경우 광고가 게재되지 않습니다.
  • Ad Exchange 동영상에 정의된 minCPM 임계값을 확인하세요. CPM이 상당히 높으면 유효노출률이 매우 낮아질 수 있습니다. 문제를 해결하려면 minCPM을 삭제하거나 광고 요청(예: 슬롯 이름)에서 광고 단위 매개변수를 삭제하여 유효노출률에 영향을 미치는지 확인하세요.
좋은 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를 내 Ad Manager 광고 태그의 sz와 동일한 값으로 설정해야 하나요?
반드시 그런 것은 아닙니다. adSlotWidth 및 adSlotHeight는 광고를 채울 플레이어 또는 영역의 너비/높이로 설정해야 합니다. 이 정보를 사용하여 애드센스에서 해당 공간에 게재할 수 있는 광고를 결정합니다. Ad Manager 광고 태그의 sz 키-값 쌍은 타겟팅 매개변수이며 게재된 광고 소재에 반드시 영향을 미치는 것은 아닙니다(자세한 내용은 아래 참고).
데모 광고 태그는 멋있는데 내 광고 태그로 바꾸면 광고가 표시되지 않습니다.
요청하려는 광고 태그에 트래피킹된 것이 있는지 확인하세요. HTTP 트래픽을 확인하는 것이 가장 쉽습니다. 1x1 픽셀 grey.gif 이미지가 HTML 앵커 블록 내에 반환되면 Ad Manager에서 타겟팅을 확인해야 합니다.
같은 태그를 여러 번 사용하여 광고를 요청하고 싶지만 첫 번째 요청 시에만 광고가 표시됩니다. 이 문제를 해결하려면 어떻게 해야 하나요?
광고를 두 번 이상 요청하는 경우 실수로 중복된 요청이 아니라 합법적인 요청임을 광고 서버에 알려야 합니다. SDK는 2개의 빠른 API 호출을 통해 이를 수행합니다.
  1. AdsManager 인스턴스에서 destroy()를 호출합니다. 이렇게 하면 아래에서 contentComplete()를 호출할 때 포스트롤이 재생되지 않습니다. 다음번 요청을 할 때 새 AdsManager를 받습니다.
  2. AdsLoader 인스턴스에서 contentComplete()를 호출합니다. 이렇게 하면 새 광고 요청이 이전 요청과 겹치지 않도록 SDK가 재설정됩니다.
위 두 가지를 호출한 후 AdsLoader 인스턴스에서 requestAds()를 호출하여 새 동영상에서 재생할 다른 광고 모음을 가져올 수 있습니다.
IMA SDK를 사용하여 오버레이 및 전체 슬롯 애드센스 광고를 요청하려면 어떻게 해야 하나요?

SDK를 사용하여 애드센스 광고를 요청하려면 먼저 애드센스 광고 태그를 가져와야 합니다. 자세한 내용은 동영상용 애드센스 페이지를 참조하세요. 태그가 있으면 다음 단계에 따라 오버레이 또는 전체 슬롯 광고 요청을 수행해야 합니다.

오버레이 광고
  1. AdsRequest에서 ViewModes를 NORMAL로 설정합니다.
  2. 광고 태그에 overlay=1 매개변수를 추가합니다.
전체 슬롯 광고
  1. AdsRequest에서 ViewModes를 FULLSCREEN로 설정합니다.
  2. 광고 태그에 overlay=0 매개변수를 추가합니다.
광고를 클릭하면 '무효 클릭연결 URL' 오류가 발생합니다. 원인은 무엇일까요?
이 오류의 가장 일반적인 원인은 부적절하게 이스케이프 처리된 클릭연결 URL입니다. 이 오류가 발생하면 클릭연결 URL이 VAST 응답에서 올바르게 이스케이프 처리되었는지 확인하세요.
'VAST 문서가 비어 있음' 오류가 표시되는 이유는 무엇인가요?
이 오류는 광고 태그가 빈 VAST 문서를 반환할 때 발생하는데, 광고가 제대로 게재되지 않았음을 나타냅니다. 계정 관리자 또는 광고 서버 담당자에게 문의하여 광고 태그가 작동하지 않는 이유를 알아보세요.
광고 건너뛰기 상자 또는 기타 UI 요소의 크기/텍스트를 변경할 수 있나요?
IMA SDK는 UI 요소의 레이아웃, 크기 또는 콘텐츠 변경을 지원하지 않습니다. UI 요소에 관한 자세한 내용은 AdsManager.uiElements를 참고하세요.
HTML5 SDK에서 네이티브 동영상 컨트롤이 지원되나요?
아니요. HTML5 SDK는 네이티브 컨트롤을 지원하지 않습니다.
HTML5 구현에서 ''HTMLMediaElement'에서 '재생'을 실행하지 못했습니다. API는 사용자 동작으로만 시작할 수 있습니다'라는 메시지가 표시됩니다. 이 문제를 해결하려면 어떻게 해야 하나요?
휴대기기에서는 사용자 액션 (예: 탭)의 결과로 adDisplayContainer.initialize()를 호출해야 합니다. 이 오류가 표시되는 경우 사용자가 시작하지 않은 컨텍스트에서 호출되었을 가능성이 높습니다. 사용자 작업의 직접 결과여야 합니다. 예를 들어 동영상을 재생하여 '탭' 이벤트에 응답한 다음 동영상 플레이어의 '재생' 이벤트를 사용하여 initialize()를 호출하면 SDK에서 이 오류를 반환합니다. 탭 이벤트 자체의 결과로 initialize()를 호출해야 합니다.
광고 클릭에 키보드 집중을 처리하려면 어떻게 해야 하나요?
플레이어에 키보드 컨트롤을 사용하면 adDisplayContainer를 클릭한 후 더 이상 작동하지 않을 수 있습니다. 광고를 클릭하면 키보드 포커스가 IMA iframe으로 전환되기 때문입니다. 콘텐츠 플레이어에 키보드 포커스를 유지하려면 CLICK 이벤트를 사용하여 키보드 포커스를 원하는 컨테이너로 다시 이전하세요. 자세한 내용은 다음 코드 스니펫을 참조하세요. 
adsManager.addEventListener(
      google.ima.AdEvent.Type.CLICK,
      function(){
        window.focus();
        // Or another method to return focus to the desired container.
      });