게임용 애드센스(AFG)

동영상용 애드센스의 IMA용 게임 태그 매개변수

동영상용 애드센스 및 게임용 애드센스 제품은 콘텐츠용 애드센스에서 매우 다양한 태그 추가 구조를 사용합니다. 여기에는 양방향 미디어 광고(IMA) 태그가 필요하며, Google IMA SDK 통합이 가능하거나 VAST 및 VPAID와 호환(예: IMA 어댑터)되는 동영상 또는 게임 런처에서 호출했을 경우에만 광고를 반환합니다.

이러한 태그는 일반적으로 게임용 애드센스 태그 생성기를 사용하여 만들 수 있습니다. 아래에서 이러한 광고 태그에 대해 설정할 수 있는 다양한 기준의 종합적인 목록을 볼 수 있습니다. 광고를 게재하기 위해 게임용 애드센스에 필요한 필수 매개변수는 단지 몇 개에 불과하지만, 채널 ID, 최소 최대 광고 길이, 언어 등 다른 매개변수를 추가하여 원하는 광고 반응을 얻을 수 있습니다.

IMA 광고 태그 매개변수 필수 여부
ad_type
client
description_url 예 - URL 인코딩 필수
channel 아니요 - 사용 가능할 경우 권장
adsafe 아니요 - 권장
videoad_start_delay 아니요 - 권장
hl 아니요 - 권장
max_ad_duration 아니요 - 권장
min_ad_duration 아니요 - 권장
sdmax 아니요 - 권장
adtest 아니요
cust_age 아니요
cust_gender 아니요
host 아니요
h_ch 아니요

기본 URL

아래에 설명된 모든 검색어 매개변수에 대한 기본사항을 다음 URL에서 확인할 수 있습니다.
https://googleads.g.doubleclick.net/pagead/ads?

필수 매개변수

ad_type
(문자열) 원하는 광고의 유형을 지정합니다. 각 매개변수는 밑줄(‘_’)을 사용하여 연결해야 합니다.

  • video: 모든 동영상 광고를 허용합니다. standardvideo_skippablevideo_bumpervideo와 동일합니다.
  • skippablevideo: 건너뛸 수 있는 동영상 광고만 허용합니다. 건너뛸 수 있는 광고를 수신하려면 추가적인 게시자 권한이 필요할 수 있습니다. 
  • bumpervideo: 6초 길이의 건너뛸 수 없는 동영상 광고만 허용합니다.
  • standardvideo: 건너뛸 수 없는 동영상 광고만 허용합니다. 
  • image: 특정 비선형 슬롯 크기에 들어갈 수 있는 이미지 광고를 허용합니다. 
  • text: 텍스트 광고를 허용합니다.

  • &ad_type=video_text_image
    • 모든 형식을 허용합니다.
  • &ad_type=video_text
    • 모든 동영상 형식 및 텍스트 광고를 허용합니다.
  • &ad_type=standardvideo_image
    • 건너뛸 수 없는 일반 동영상 및 이미지 광고만 허용합니다.

client

(문자열) 게시자의 웹 속성 ID입니다.

: &client=ca-games-pub-4968145218643279


description_url

(문자열) 동영상을 설명하는 HTML 페이지의 URL 인코딩된 전체 URL입니다. description_url 값은 서버측 프로그래밍 언어를 사용하여 동적으로 생성하거나 온라인 URL 인코딩 도구를 사용하여 수동으로 생성합니다.

: &description_url=http%3A%2F%2Fmyurl.com%2Fpage%3Fkey%3Dvalue%26key2%3Dvalue2


URL 예

다음은 최소한의 필수 매개변수가 포함된 URL의 예입니다. https://googleads.g.doubleclick.net/pagead/ads?client=ca-video- afvtest&ad_type=video&description_url=http%3A%2F%2Fmyurl.com%2Fpage%3Fkey%3Dvalu e%26key2%3Dvalue2

설명 URL http:// myurl.com/page?key=value&key2=value2를 사용하여 게시자 ca-video-afvtest를 위한 동영상 광고를 요청합니다.

선택 매개변수

channel

(문자열) 애드센스 타겟팅 및 보고서에 사용되는 더하기('+') 기호로 구분된 채널 목록입니다. 광고 요청당 채널을 최대 5개까지 전달할 수 있습니다.

: &channel=mychannel+otherchannel+targetingchannel


adsafe

(문자열) 게재되는 광고를 필터링하는 데 사용되는 설정을 결정합니다. 기본값은 'high'입니다.

  • high - (기본값) 가족용 광고를 게재합니다. 비가족용 광고나 성인 콘텐츠 광고는 게재되지 않습니다.
  • medium - 가족용 및 비가족용 광고(예: 도박이나 처방 의약품에 대한 광고 등)를 게재합니다. 성인용 광고는 게재하지 않습니다. 

: &adsafe=high


adtest

(문자열) 테스트 구현 여부를 지정합니다. 사용할 수 있는 값은 'on' 또는 'off'입니다. 이 매개변수를 'on'으로 설정하면 동영상용 애드센스(AFV) 계정에 노출수 및 클릭수가 기록되지 않습니다. 테스트하는 동안에는 이 매개변수를 반드시 사용해야 합니다. 설정하지 않으면 기본값은 'off'입니다.

  • off - (기본값) 모든 광고에 대해 정상적으로 광고비가 청구됩니다. 테스트가 아닌 프로덕션에 사용해야 하는 설정입니다. 
  • on - 테스트 중에 어떤 노출수나 클릭수도 기록하지 않도록 하는 설정입니다.

예: &adtest=on


videoad_start_delay

(정수) 동영상에서 광고가 재생될 밀리초 단위의 시간입니다. 미드롤 값으로 기본 설정되며, 구체적인 값은 '1'이 적용됩니다.

:

  • -1 - 콘텐츠의 끝 부분에 게재될 포스트롤 광고를 지정합니다.
  • 0 - 콘텐츠 재생이 시작되기 전에 표시될 프리롤 광고를 지정합니다.
  • 임의의 양의 정수 - 콘텐츠 재생 후 숫자로 지정한 밀리초 단위의 시간이 지난 다음 재생될 미드롤 광고를 지정합니다. 

:

  • &videoad_start_delay=-1 - 포스트롤입니다.
  • &videoad_start_delay=15000 - 콘텐츠가 시작되고 15초 지점에서 광고가 재생됩니다.

cust_age

(정수) 사용자의 나이를 지정합니다. 정확한 나이를 지정할 수 있으며, com.google.ads.ima.api.Demographics에서 정의된 연령대도 지정합니다.

:

  • &cust_age=1001 - 18~24세
  • &cust_age=38 - 정확히 38세

cust_gender

(정수) 사용자의 성별을 com.google.ads.ima.api.Demographics에서 정의된 연령대도 지정합니다.

:

  • 1 - 남성
  • 2 - 여성

:

  • &cust_gender=1 - 남성 
  • &cust_gender=2 - 여성

host

(문자열) 3방향 수익 공유에 사용하기 위한 호스트 ID입니다.

: &host=ca-host-test - 이 호스트와 수익을 분할합니다.


h_ch

(문자열) 해당 호스트의 애드센스 타겟팅 및 보고서 채널 ID를 의미하는 더하기('+') 기호로 구분된 문자열 목록입니다.

: &h_ch=channel1+channel2+channel3 - 해당 호스트에 대해 이와 같은 추가적인 채널을 타겟팅하고 보고서를 생성합니다.


ht_id

(숫자) 게시자와 호스트 사이의 수익 공유 수준을 지정하는 데 사용되는 계층 ID입니다.

Example: &ht_id=2 - 2차 호스트입니다.


hl

(문자열) 해당 언어로 광고를 요청하는 데 사용되는 언어 코드입니다. 임의의 ISO 639-1(2글자) 또는 ISO 639-2(3글자) 코드일 수 있습니다. 유효한 코드 목록

:

  • &hl=en - 영어
  • &hl=es - 스페인어

max_ad_duration

(정수) 반환해야 하는 최대 동영상 길이를 밀리초 단위로 지정합니다. 설정하지 않을 때의 기본값은 100초입니다.

: &max_ad_duration=30000 - 건너뛸 수 없는 광고의 최대 길이는 30초입니다.


min_ad_duration

(정수) 반환해야 하는 최소 동영상 길이를 밀리초 단위로 지정합니다. 설정하지 않을 때의 기본값은 0초입니다.

:

  • &min_ad_duration=15000 - 반환된 건너뛸 수 없는 광고의 길이는 15초 이상이어야 합니다.
  • &min_ad_duration=0 - 광고 길이가 max_ad_duration 값에 의해서만 제한됩니다. 

sdmax

(정수) 건너뛸 수 있는 광고에 대해 최대 동영상 길이를 밀리초 단위로 지정합니다. 설정하지 않을 때의 기본값은 무제한입니다.

: &sdmax=120000 - 반환된 건너뛸 수 있는 광고의 길이는 2분을 초과할 수 없습니다.


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