이 가이드를 통해 Google IMA HTML5 SDK와 통합하여 애드센스로 HTML 5 웹 게임에 광고를 게재하는 방법에 대해 알아보세요.
기술 설정 개요
게임용 애드센스는 모두 Google 양방향 미디어 광고 소프트웨어 개발 키트(IMA HTML5 SDK)를 사용하여 작동합니다. 이 SDK를 사용하면 자바스크립트를 통해 애드센스 광고를 요청하여 콘텐츠와 관련성 높은 광고를 게재할 수 있습니다.
IMA HTML5 SDK를 통해 광고를 요청하고 렌더링하려면 광고 요청을 설정하고 이에 따라 관련 광고를 로드한 후 적절한 시기에 재생하세요. 기본 게시자 ID ca-games-pub-4968145218643279
를 사용하여 통합을 테스트하세요.
먼저 IMA SDK를 사용한 광고 통합 예제를 계정 관리자에게 제출하여 승인을 받아야 사이트에 광고를 게재할 수 있습니다.
간단 통합
간단 통합 옵션은 게임용 애드센스를 HTML5 게임과 통합하는 가장 쉬운 방법입니다. 이 옵션은 게임용 애드센스에서 사용할 수 있는 모든 기능과 광고 형식을 제공하는 간편한 구현 솔루션을 제공합니다.
이 간단 통합 옵션을 사용하려는 게시자는 관심 사항으로 등록할 수 있습니다.
고급 통합
고급 및 맞춤 통합을 원하는 게시자는 전체 IMA HTML5 SDK를 HTML5 게임에 구현해야 합니다. 이 옵션은 Google Ad Manager를 통해 제공되는 특정 기능과 같은 추가 유연성을 제공하지만, 이 옵션을 사용하면 복잡성이 추가되기도 합니다.
고급 통합 시작하기
먼저 IMA HTML5 SDK를 게임에 통합합니다.
- IMA HTML5 SDK 통합 설정
Google Developer 사이트에 설명된 가이드라인을 준수하여 IMA HTML5 SDK를 게임에 통합합니다. 시작하는 방법, 다운로드할 수 있는 샘플 코드, 전체 API 참조를 참조하면 도움이 됩니다.
- 광고 컨테이너 설정(
AdDisplayContainer)
IMA HTML5 SDK는 동영상 게시자와 게임 게시자를 모두 지원하므로 여러 가지 방법으로
AdDisplayContainer
개체를 설정할 수 있습니다.게임용 애드센스와 함께 사용할
AdDisplayContainer
개체를 설정할 때 광고를 포함할 div 관련 참조를 전달하기만 하면 됩니다.예:
var adDisplayContainer = new google.ima.AdDisplayContainer(document.getElementById('adContainer'));
- 광고 요청 구성(
AdsRequest
)AdsRequest
개체를 만들 때 광고가 반환되고 제대로 렌더링되도록 관련 매개변수 및 속성이 올바르게 구성되었는지 확인해야 합니다.예:
// 게임용 애드센스 광고를 요청합니다.
var adsRequest = new google.ima.AdsRequest();
// 게임용 애드센스 광고 태그 설정
adsRequest.adTagUrl = 'https://googleads.g.doubleclick.net/pagead/ads?ad_type=video_image_text&client=ca-games-pub-4968145218643279&videoad_start_delay=0&description_url=http%3A%2F%2Fwww.google.com&max_ad_duration=20000&adtest=on';
// 풀슬롯 UI로 이미지 또는 텍스트 광고를 렌더링하도록 하기
adsRequest.forceNonLinearFullSlot = true;
// 선형 및 비선형 슬롯 크기를 지정합니다.
adsRequest.linearAdSlotWidth = {your_game_width};
adsRequest.linearAdSlotHeight = {your_game_height};
adsRequest.nonLinearAdSlotWidth = {your_game_width};
adsRequest.nonLinearAdSlotHeight = {your_game_height}; - 관련 이벤트 수신 및 콜백 생성
광고 게재가 언제 중단되는지 알고 사용자가 계속 게임을 하게 허용할 수 있도록 IMA SDK 내에서 발생하는 이벤트를 수신하는 것이 중요합니다.
다음은 게임 콘텐츠를 포함한 광고의 게재위치를 결정하는 데 일반적으로 사용되는 일 부 광고 이벤트입니다. 예를 들어
COMPLETE
이벤트를 수신하면 광고 재생이 완료된 시점을 파악한 다음 게임 콘텐츠를 사용자에게 표시할 수 있습니다. 광고 이벤트의 전체 목록은 API 참조에서 모두 확인할 수 있습니다.이벤트 이름 설명 AdEvent.Type.CLICK
광고 클릭 시 발생됩니다. AdEvent.Type.COMPLETE
광고 재생이 완료되면 발생됩니다. AdEvent.Type.LOADED
광고 데이터를 사용할 수 있을 때 발생됩니다. AdEvent.Type.SKIPPED
사용자가 광고를 건너뛰면 발생됩니다. AdEvent.Type.START
광고 재생이 시작되면 발생됩니다. AdEvent.Type.USER_CLOSE
사용자가 광고를 닫으면 발생됩니다. AdErrorEvent.Type.AD_ERROR
광고 오류 이벤트가 발생하면 발생됩니다.
발생할 수 있는 다양한 유형의 광고 오류가 있습니다. 예를 들면 광고 미디어 애셋 로드 실패 또는 광고 요청 시 비어 있는 광고 응답 반환이 있습니다. 발생할 수 있는 오류 목록은 API 참조에서 확인할 수 있습니다.