동영상용 애드센스 및 게임용 애드센스 제품은 콘텐츠용 애드센스에서 매우 다양한 태그 추가 구조를 사용합니다. 여기에는 양방향 미디어 광고(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 | 아니요 |
overlay | 아니요 |
기본 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-video-afvtest
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분을 초과할 수 없습니다.
overlay
(정수) 요청한 비선형 오버레이 크기를 아래 3분의 1 부분으로만 제한하는 데 사용합니다. 기본적으로 제한이 설정되어 있지 않습니다.
예:
- &overlay=1 - 광고 요청은 하단의 3분의 1 오버레이 크기만 사용할 수 있습니다. 풀슬롯 오버레이는 요청할 수 없습니다.
- &overlay=0 - 기본 값으로 오버레이 크기의 제한이 없습니다. AdsRequest.nonLinearAdSlotWidth 및 adsRequest.nonLinearAdSlotHeight에 따라 오버레이 크기가 사용됩니다.