참조

매개변수

페이지 수준 매개변수 설명

이 매개변수는 페이지당 한 번만 지정하면 됩니다. 페이지의 모든 광고 단위에 영향을 미칩니다.

필수

매개변수 설명 및 예시
adPage 사용자가 다음 결과 페이지 또는 이전 결과 페이지로 이동할 때 필요합니다.

adPage 매개변수는 광고가 게재되는 결과 페이지를 지정합니다. 이 매개변수는 사용자가 검색 결과의 첫 번째 페이지 이후의 페이지를 탐색할 때 사용됩니다. 예를 들어 5개의 광고가 요청되고 adPage 매개변수가 2로 설정된 경우 반환되는 광고는 5개의 광고 중 두 번째 페이지입니다.

pubId 필수
애드센스 client-ID입니다. pubId는 client-ID에서 'partner-' 뒤에 나오는 부분입니다. 예를 들어 client-ID가 'partner-test-property'인 경우 pubId는 'test-property'입니다. 이는 CSA의 표준 프로토콜입니다.

예: 

'pubId' : 'test-property'
query 콘텐츠 페이지의 관련 검색어를 제외하고 필수입니다.
사용자가 입력하는 검색어입니다. query 매개변수의 값은 인코딩되지 않아야 합니다.

참고: 콘텐츠 페이지의 관련 검색어에 이 매개변수를 사용하면 예기치 않은 결과가 발생합니다.

예: 

'query' : 'flowers'
 
'query' : 'black & decker'
 
'query' : myQuery // myQuery is a variable containing the search query
resultsPageBaseUrl 페이지에 관련 검색어 단위가 있는 경우 필수
검색어를 사용자가 클릭한 관련 검색어로 지정하는 검색 결과 페이지의 URL을 지정합니다. resultsPageBaseUrl은 자동으로 추가되는 검색어를 제외하고 자체 매개변수를 포함할 수 있습니다.

예: 

'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2'
relatedSearchTargeting 페이지에 관련 검색어 단위가 있는 경우 필수
관련 검색어 단위가 요청되는 경우 이 매개변수는 필수입니다. 페이지 컨텍스트에 따라 표시되는 관련 검색 환경 유형을 제어합니다.
  • 'content' 콘텐츠 페이지 (예: 도움말, 블로그 게시물)의 관련 검색어에 이 옵션을 사용합니다.
  • 'query' 이 옵션은 검색 결과 페이지의 관련 검색어에 만 사용합니다.

참고: relatedSearchTargeting 페이지 매개변수는 기본적으로 'query'로 자동 설정됩니다. 하지만 이 기본값은 검색 결과 페이지용으로 만 설계되었음을 명심해야 합니다 (검색의 관련 검색어). 다른 유형의 페이지 (예: 기사, 블로그 게시물)에서 관련 검색을 사용하는 경우 매개변수를 'content'로 명시적으로 설정해야 합니다.

참고: 이 매개변수 사용 시 다음 가이드라인이 적용됩니다.

  • 이 페이지 매개변수의 값에 따라 특정 관련 검색 기능이 사용 설정 또는 사용 중지될 수 있습니다.
  • 페이지 유형을 허위로 진술하거나 검색 결과가 아닌 페이지에서 relatedSearchTargeting 매개변수의 기본 '검색어' 설정을 사용하는 것은 이 서면 안내를 위반하는 것으로 간주됩니다.
  • Google은 이 값이 수동으로 설정되었는지 또는 기본값을 사용하는지에 관계없이 주기적으로 이 값의 정확성을 확인할 수 있습니다.

예:

'relatedSearchTargeting' : 'content'
 
'relatedSearchTargeting' : 'query'
styleId 필수
페이지의 광고 또는 관련 검색어 단위에 적용할 검색 광고 맞춤 스타일의 ID를 지정합니다. 검색 광고 맞춤 스타일 사용에 대해 자세히 알아보세요. 요청에 대해 styleId가 설정된 경우, 광고 또는 관련 검색어가 스타일과 함께 렌더링되며 기존 스타일 지정 매개변수는 무시됩니다. 요청에 styleId가 지정되지 않은 경우 시스템 기본 스타일이 렌더링됩니다.

예: 

'styleId': '1234567890'

선택사항

매개변수 설명 및 예시
linkTarget 선택
광고를 클릭했을 때 동일한 창에서 열지, 새 창에서 열지 지정합니다. 기본값은 '_top'입니다. 단위 수준에서도 이 매개변수를 사용할 수 있습니다.
  • '_top' 같은 창에서 열립니다.
  • '_blank' 새 창에서 열립니다.

예: 

'linkTarget' : '_blank'
referrerAdCreative 선택
사용자가 다른 웹사이트의 광고 또는 링크를 클릭하여 관련 콘텐츠 검색 단위가 포함된 콘텐츠 페이지에 도달했는데 해당 광고 또는 링크를 관리하는 사람이 게시자 본인인 경우 이 매개변수는 해당 광고 또는 링크의 광고문안 그대로 설정해야 합니다.

이 매개변수 사용 시 다음 가이드라인이 적용됩니다.

  • 이 매개변수는 관련 콘텐츠 검색 요청 시에만 사용해야 합니다. 다른 요청에 사용할 경우 무시됩니다.
  • 다른 웹사이트에서 의도적으로 가져온 트래픽에서만 사용해야 하며 자연 트래픽에서는 사용해서는 안 됩니다.
  • 광고 또는 링크 광고 소재의 제목, 설명 또는 기타 문구가 포함되어야 합니다.
  • 광고 또는 링크 광고 소재에서 값을 생략하거나 추가 값을 포함하는 것은 이 서면 안내를 위반하는 것으로 간주됩니다.
  • 대소문자를 구분하지 않습니다.
  • 유효한 UTF-8 인코딩을 허용합니다. 유니코드 문자 / 발음 구별 부호가 지원됩니다.
  • Google은 게시자가 제출한 매개변수를 사용하거나 무시할 수 있습니다. 이 매개변수를 사용하면 검색어 선택 및 순위에 영향을 줄 수 있습니다.

참고: 이 매개변수는 terms 매개변수를 사용할 때 필수입니다.

예: 

'referrerAdCreative': 'search for ads related to dental implants'

'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis'
resultsPageQueryParam 선택
검색 결과 페이지에서 검색어의 URL 매개변수 이름을 지정합니다. 지정하지 않을 경우 기본값은 'q'입니다.

예: 

'resultsPageQueryParam' : 'query'
terms 선택
이 매개변수를 사용하면 관련 검색어 요청과 함께 표시될 나만의 관련 검색어를 쉼표로 구분된 목록으로 제공할 수 있습니다. 다만 Google은 여기서 제공한 검색어를 사용할 수도, 사용하지 않을 수도 있습니다.

참고: 이 매개변수를 사용할 때는 referrerAdCreative도 필수이며 relatedSearchTargeting가 필요하고 'content'로 설정해야 합니다.

예: 

'terms' : 'cars rental, flight ticket'
ignoredPageParams 선택사항
핵심 콘텐츠 또는 사용자 환경에 영향을 주지 않고 안전하게 무시할 수 있는 콘텐츠 관련 검색어 단위가 있는 콘텐츠 페이지의 URL 매개변수 목록을 지정합니다.

참고: 사이트에 관련 검색어가 표시되려면 Google에서 페이지를 크롤링하여 검색어가 문맥상 관련이 있는지 확인해야 합니다. 애드센스 크롤러가 아직 페이지를 크롤링하지 않았거나 크롤링을 차단한 경우 (예: robots.txt) Google에 제공한 추천 관련 검색어는 표시되지 않습니다.

콘텐츠 관련 검색 제품은 Google의 콘텐츠 크롤링 시스템을 사용하여 페이지의 색인을 생성하고 관련 검색어를 생성합니다. 추적 변수, 사용자 ID, 세션 ID, 기타 동적 식별자 등 검색어 매개변수가 포함된 콘텐츠 페이지 URL은 페이지의 핵심 콘텐츠를 평가하는 크롤러의 기능을 방해할 수 있으며 부정확하거나 관련 없는 관련 검색어를 유도할 수 있습니다. 이 페이지 매개변수는 Google 크롤러에 이러한 불필요한 매개변수를 무시하도록 지시하여 적절한 콘텐츠 색인을 생성하고 불필요한 크롤링 부하를 줄입니다. 이렇게 하면 Google에서 페이지가 이미 크롤링되었다고 더 잘 인식하고 추천 검색어 (자격요건을 충족하는 경우 Google 및 파트너의 검색어 모두)를 표시할 수 있습니다.

이 매개변수 사용 시 다음 가이드라인이 적용됩니다.

  • 이 매개변수는 관련 콘텐츠 검색 요청 시에만 사용해야 합니다. 다른 요청에 사용할 경우 무시됩니다.
  • 이 매개변수의 값은 사용자가 콘텐츠 페이지로 이동할 때 표시될 수 있는 URL 매개변수의 쉼표로 구분된 목록이어야 합니다.
  • 대소문자를 구분하며,
  • 이 목록의 URL 매개변수가 콘텐츠 페이지의 URL에서 삭제되더라도 페이지 콘텐츠, 디자인 또는 사용자 환경에 큰 영향을 미치지 않아야 합니다.
  • 페이지 콘텐츠, 모양 또는 사용자 환경에 상당한 영향을 미치는 URL 매개변수를 포함하는 것은 이 서면 안내를 위반하는 것으로 간주됩니다.
  • Google은 제공된 URL 매개변수를 무시할 때의 효과를 주기적으로 확인할 수 있습니다.

예:
사용자가 콘텐츠 페이지를 방문하고 URL이 다음과 같은 경우 

http://example.com/content?utm_medium=social&page_id=123&click_id=456
 다음과 같이 무시할 수 있는 URL 매개변수를 제공합니다. 
'ignoredPageParams' : 'utm_medium,click_id,session_ref'
 콘텐츠 페이지의 URL을 다음과 같이 처리합니다. 
http://example.com/content?page_id=123

구성 설정

매개변수 설명 및 예시
adsafe 선택
검색어와 일치하는 광고에 Google이 적용해야 하는 필터링 규칙을 지정합니다. 다음은 adsafe의 유효한 설정 및 각 값이 광고 게재에 미치는 영향입니다.
  • 'high' 가족용 광고를 반환합니다. 비가족용 광고나 성인용 광고는 게재하지 않습니다.
  • 'medium' 가족용 광고와 비가족용 광고를 반환합니다. 성적인 콘텐츠 광고는 게재하지 않습니다.
  • 'low' 모든 유형의 광고를 반환합니다.

기본적으로 adsafe는 high로 설정됩니다.

예: 

'adsafe': 'medium'
adtest 선택
adtest 매개변수는 광고 요청이 테스트임을 나타내는 데 사용됩니다. adtest 매개변수의 값이 on이면 Google에서는 요청을 테스트로 간주하고 광고 노출수로 계산하거나 클릭 결과를 추적하지 않습니다.

adtest 매개변수 값이 on인 경우 수익이 발생하지 않습니다.

사이트 탭에서 승인되지 않은 도메인에서 adtest 매개변수가 on으로 설정된 광고 요청은 '테스트 광고' 오버레이가 포함되고 클릭할 수 없는 광고를 반환합니다.

이 매개변수를 테스트 용도가 아닌 실제 광고 서비스에 이용할 경우 광고 게재에 따른 수익이 지급되지 않습니다.

adtest의 기본값은 사용 중지되어 있습니다.

예: 

'adtest' : 'on'
channel 선택
여러 페이지의 실적을 추적하기 위해 검색용 애드센스 채널을 포함할 수 있습니다. 애드센스 계정 또는 기술계정 관리자가 만든 고유한 채널 ID를 사용합니다. 채널에 대한 자세한 내용은 여기를 참고하세요.

채널이 여러 개인 경우 '+' 기호로 구분해야 합니다.

예: 

'channel' :  'testA'  
'channel' :  'testA+testB'
hl 선택
요청된 광고 또는 관련 검색어가 타겟팅할 언어를 나타냅니다. 기본값은 en입니다.

Google에서는 AdWords API 언어 코드를 모두 지원합니다.

참고: 광고주는 광고가 타겟팅하는 언어를 지정합니다. 요청에 이 매개변수를 포함하면 해당 언어를 타겟팅하거나 모든 언어를 타겟팅하는 광고만 게재됩니다. 단, 광고문안이 지정된 언어로 표시되지 않을 수도 있습니다.

일반적으로 hl 매개변수 값은 이 매개변수를 전송하는 페이지의 기본 언어로 설정해야 합니다.

예: 

'hl' : 'es'
ie 선택사항

ie 매개변수는 쿼리 문자열을 해석하는 데 사용할 문자 인코딩 스키마를 설정합니다.

기본 ie 값은 utf-8입니다.

값 표준 이름 관련 지원 언어
latin1 ISO-8859-1 서유럽어 (카탈루냐어, 덴마크어, 네덜란드어, 영어, 핀란드어, 프랑스어, 독일어, 인도네시아어, 이탈리아어, 노르웨이어, 포르투갈어, 스페인어, 스웨덴어)
latin2 ISO-8859-2 동유럽어 (크로아티아어, 체코어, 헝가리어, 폴란드어, 루마니아어, 세르비아어, 슬로바키아어, 슬로베니아어)
latin3 ISO-8859-3  
latin4 ISO-8859-4 발트어 (에스토니아어, 라트비아어, 리투아니아어)
cyrillic ISO-8859-5 불가리아어, 러시아어
arabic ISO-8859-6  
그리스/그리스인 ISO-8859-7 그리스어
히브리 ISO-8859-8 히브리어
latin5 ISO-8859-9  
latin6 ISO-8859-10 아이슬란드어
euc-jp EUC-JP 일본어
euc-kr EUC-KR 한국어
sjis Shift_JIS 일본어
big5 Big5 중국어 번체
gb GB2312 중국어 간체
utf-8 UTF-8 전체
oe 선택사항

oe 매개변수는 Google에서 광고의 텍스트를 인코딩하는 데 사용해야 하는 문자 인코딩 스키마를 설정합니다. 기술적으로는 선택사항이지만 이 매개변수의 값을 전달하는 것이 좋습니다.

기본 oe 값은 utf-8입니다.

값 표준 이름 관련 지원 언어
latin1 ISO-8859-1 서유럽어 (카탈루냐어, 덴마크어, 네덜란드어, 영어, 핀란드어, 프랑스어, 독일어, 인도네시아어, 이탈리아어, 노르웨이어, 포르투갈어, 스페인어, 스웨덴어)
latin2 ISO-8859-2 동유럽어 (크로아티아어, 체코어, 헝가리어, 폴란드어, 루마니아어, 세르비아어, 슬로바키아어, 슬로베니아어)
latin3 ISO-8859-3  
latin4 ISO-8859-4 발트어 (에스토니아어, 라트비아어, 리투아니아어)
cyrillic ISO-8859-5 불가리아어, 러시아어
arabic ISO-8859-6  
그리스/그리스인 ISO-8859-7 그리스어
히브리 ISO-8859-8 히브리어
latin5 ISO-8859-9  
latin6 ISO-8859-10 아이슬란드어
euc-jp EUC-JP 일본어
euc-kr EUC-KR 한국어
sjis Shift_JIS 일본어
gb GB2312 중국어 간체
utf-8 UTF-8 전체
ivt 선택사항
이 매개변수를 사용하면 동의한 트래픽과 동의하지 않은 트래픽 모두에 무효 트래픽 전용 쿠키 및 로컬 스토리지를 사용하는 광고만 허용하겠다는 것을 Google에 알리는 불리언 값을 제공할 수 있습니다.
  • true 이 매개변수가 없거나 'true'로 설정된 경우 무효 트래픽 전용 쿠키가 설정되고 동의 트래픽에 대해서만 로컬 스토리지가 사용됩니다.
  • false 이 매개변수를 'false'로 설정하면 Google에서 무효 트래픽 전용 쿠키를 설정하고 동의 트래픽과 비동의 트래픽 모두에 로컬 스토리지를 사용합니다.

기본적으로 IVT는 true로 설정됩니다.

예: 

'ivt': false

광고 단위 수준 매개변수 설명

페이지의 개별 광고 단위가 사용자에게 게재되는 방식에 영향을 주는 매개변수입니다. 광고 단위마다 매개변수를 개별적으로 설정할 수 있습니다.

필수

매개변수 설명 및 예시
container 필수
광고가 게재될 빈 광고 컨테이너 <div>의 ID입니다.

예: 

'container' : 'afscontainer1'
maxTop 광고 단위가 검색 결과 위에 있는 경우 필수입니다.

상단 광고 단위에 게재될 광고 수를 지정하려면 이 매개 변수를 사용하세요.

참고: 이 매개변수는 'number' 매개변수 대신 사용됩니다. 이 광고 단위는 광고의 첫 번째 줄이 줄바꿈되지 않도록 폭이 충분히 넓어야 합니다. 페이지의 다른 게재위치에 maxTop 매개변수를 사용하는 것은 정책 위반입니다.

예:

'maxTop' : 4
width 필수
광고 또는 관련 검색어 단위의 너비를 픽셀로 지정합니다.

예: 

'width' : '700px'
 
'width' : 700

구성 설정

매개변수 설명 및 예시
adLoadedCallback 선택
광고 또는 관련 검색어가 로드되었거나 광고 또는 관련 검색어가 게재되지 않은 경우 호출할 JavaScript 함수를 지정합니다. 매개변수는 광고 호출이 완료될 때 특정 작업이 실행되도록 하기 위해 구현하는 JavaScript 콜백 함수로 설정해야 합니다.

이 콜백 함수는 다음과 같은 매개변수를 사용합니다.

containerName 광고 또는 관련 검색어 단위의 컨테이너 이름입니다.
adsLoaded 표시할 광고 또는 관련 검색어가 하나 이상 있는 경우 true로 설정하고 반환된 광고 또는 관련 검색어가 없으면 false로 설정합니다.
isExperimentVariant 맞춤 스타일 지정 실험이 진행 중이고 광고를 렌더링하기 위해 실험의 대안이 선택된 경우 true로 설정합니다.
callbackOptions 다음 필드가 포함된 JSON 객체입니다.
termPositions: 관련 검색어 블록의 경우 게시자가 제공한 검색어의 map<string,int>을 포함하여 응답에서 이러한 검색어의 위치 색인을 0으로 지정합니다. 검색어가 제공되었지만 반환되지 않은 경우 지도에 표시되지 않습니다.

참고: 콜백 함수를 테스트하여 오류가 발생하지 않는지 확인합니다. 특히 페이지 로드에 방해가 될 수 있는 오류가 있는지 확인하세요.

JavaScript 콜백 예시: 

var adblock1 = {
  'container' : 'adblock1_div_id',
  'adLoadedCallback' : function(containerName, adsLoaded,
    isExperimentVariant, callbackOptions) {
    if (adsLoaded) {
       try {
         // most likely do nothing
       } catch (e) {
         alert ("Error in callback function");
         // Do something to handle error gracefully
       }
    } else {
       // as you always do when there is no ad coverage from Google
    }
  }
};
number 선택
광고 단위에 게재할 광고의 수입니다. 기본값은 2입니다.

예: 

'number' : 4
relatedSearches 선택
광고 단위에 표시할 관련 검색어의 수입니다. 지정하지 않을 경우 기본값은 0입니다.

예: 

'relatedSearches' : 4