게임용 애드센스(AFG)

퀵스타트 기술 가이드(게임용 애드센스)

게임용 애드센스를 사용하여 IMA HTML5 SDK로 HTML5 웹 게임에 애드센스 광고를 게재하는 방법에 관한 엔지니어용 시작 안내서입니다.

개요

게임용 애드센스는 모두 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 고급 통합 시작하기

고급 통합 옵션을 시작하려면 먼저 IMA HTML5 SDK를 게임에 통합해야 합니다.

  1. IMA HTML5 SDK 통합 설정

    Google Developer 사이트에 설명된 가이드라인을 준수하여 IMA HTML5 SDK를 게임에 통합합니다. 시작하는 방법, 다운로드할 수 있는 샘플 코드, 전체 API 참조를 참조하면 도움이 됩니다.

  2. 광고 컨테이너 설정(AdDisplayContainer)

    IMA HTML5 SDK는 동영상 게시자와 게임 게시자를 모두 지원하므로 여러 가지 방법으로 AdDisplayContainer 개체를 설정할 수 있습니다.

    게임용 애드센스와 함께 사용할 AdDisplayContainer 개체를 설정할 때 광고를 포함할 div 관련 참조를 전달하기만 하면 됩니다.

    예:

    var adDisplayContainer = new google.ima.AdDisplayContainer(document.getElementById('adContainer'));

  3. 광고 요청 구성(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};

  4. 관련 이벤트 수신 및 콜백 생성

    광고 게재가 언제 중단되는지 알고 사용자가 계속 게임을 하게 허용할 수 있도록 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 참조에서 확인할 수 있습니다.

도움이 되었나요?
어떻게 하면 개선할 수 있을까요?