매개변수
페이지 수준 매개변수 설명
이 매개변수는 페이지당 한 번만 지정하면 됩니다. 페이지의 모든 광고 단위에 영향을 미칩니다.
필수
| 매개변수 | 설명 및 예 |
|---|---|
adPage
|
사용자가 다음 결과 페이지 또는 이전 결과 페이지로 이동할 때 필요합니다.
|
pubId
|
필수 애드센스 client-ID입니다. pubId는 client-ID의 일부로 'partner-' 뒤에 표시됩니다. 예를 들어 client-ID가 'partner-test-property'인 경우 pubId는 'test-property'입니다. 이는 CSA의 표준 프로토콜입니다. 예시: 'pubId' : 'test-property' |
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
|
페이지에 관련 검색어 단위가 있는 경우 필수 항목입니다. 이 매개변수는 관련 검색어 단위가 요청되는 경우 필수입니다. 페이지 컨텍스트에 따라 표시되는 관련 검색어 환경의 유형을 제어합니다.
참고:relatedSearchTargeting 페이지 매개변수는 기본적으로 'query'로 자동 설정됩니다. 하지만 이 기본값은 검색결과 페이지에만 (Google 검색의 관련 검색어) 설계되었다는 점에 유의해야 합니다. 다른 유형의 페이지 (예: 기사, 블로그 게시물)에서 관련 검색어를 사용하는 경우 명시적으로 매개변수를 'content'로 설정해야 합니다. 참고: 이 매개변수 사용 시 다음 가이드라인이 적용됩니다.
예를 들면 다음과 같습니다. 'relatedSearchTargeting' : 'content' 'relatedSearchTargeting' : 'query' |
styleId
|
필수 페이지의 광고 또는 관련 검색어 단위에 적용할 맞춤 검색 스타일의 ID를 지정합니다. 맞춤 검색 스타일 사용에 대해 자세히 알아보세요. 요청에 styleId가 설정된 경우 광고 또는 관련 검색어가 스타일과 함께 렌더링되고 기존 스타일 지정 매개변수는 무시됩니다. 요청에 styleId가 지정되지 않은 경우 시스템 기본 스타일이 렌더링됩니다. 예시: 'styleId': '1234567890' |
선택사항
| 매개변수 | 설명 및 예 |
|---|---|
linkTarget
|
선택 광고를 클릭할 때 동일한 창에서 열지 새 창에서 열지 지정합니다. 기본값은 '_top'입니다. 이 매개변수는 단위 수준에서도 사용할 수 있습니다.
예시: 'linkTarget' : '_blank' |
maxTermLength
|
선택사항 공백을 포함한 관련 검색어의 최대 문자 수를 지정합니다. 설정하지 않으면 최댓값이 없습니다. 예시: 'maxTermLength' : 50 |
referrerAdCreative
|
선택사항 사용자가 다른 웹사이트의 광고 또는 링크를 클릭하여 콘텐츠 관련 검색어 단위가 포함된 콘텐츠 페이지에 도착하고 해당 광고 또는 링크를 관리 중인 경우 이 매개변수를 해당 광고 또는 링크의 광고 소재 텍스트로 설정해야 합니다. 이 매개변수 사용 시 다음 가이드라인이 적용됩니다.
참고: 이 매개변수는 예: 'referrerAdCreative': 'search for ads related to dental implants' 'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis' |
resultsPageQueryParam
|
선택 검색결과 페이지에서 검색어의 URL 매개변수 이름을 지정합니다. 지정하지 않을 경우 기본값은 'q'입니다. 예시: 'resultsPageQueryParam' : 'query' |
terms
|
선택 이 매개변수를 사용하면 관련 검색어 요청과 함께 반환될 자체 관련 검색어 목록을 쉼표로 구분하여 제공할 수 있습니다. 단, Google은 여기에 제공된 용어를 사용할 수도 있고 사용하지 않을 수도 있습니다.
참고: 이 매개변수를 사용할 때는 예: 'terms' : 'cars rental, flight ticket' |
ignoredPageParams
|
선택사항 핵심 콘텐츠나 사용자 환경에 영향을 주지 않고 안전하게 무시할 수 있는 콘텐츠 관련 검색어 단위가 있는 콘텐츠 페이지의 URL 매개변수 목록을 지정합니다. 참고: 관련 검색어가 사이트에 표시되려면 Google에서 페이지를 크롤링하여 용어가 맥락적으로 관련이 있는지 확인해야 합니다. 애드센스 크롤러가 페이지를 아직 크롤링하지 않았거나 robots. txt에 의해 크롤링이 차단된 경우 (예: robots.txt에 의해) Google에 제공하는 추천 관련 검색어는 표시되지 않습니다. 콘텐츠 관련 검색어 제품은 Google의 콘텐츠 크롤링 시스템을 사용하여 페이지의 색인을 생성하고 관련 검색어를 생성합니다. 추적 변수, 사용자 ID, 세션 ID, 기타 동적 식별자와 같은 검색어 매개변수가 포함된 콘텐츠 페이지 URL은 페이지의 핵심 콘텐츠를 평가하는 크롤러의 기능을 방해하여 부정확하거나 관련 없는 관련 검색어로 이어질 수 있습니다. 이 페이지 매개변수는 Google 크롤러가 필수가 아닌 매개변수를 무시하도록 지시하여 적절한 콘텐츠 색인을 보장하고 불필요한 크롤링 로드를 줄입니다. 이렇게 하면 Google에서 페이지를 이미 크롤링한 것으로 더 잘 인식하고 추천 검색어 (해당되는 경우 Google과 파트너 모두의 검색어)를 표시할 수 있습니다. 이 매개변수 사용 시 다음 가이드라인이 적용됩니다.
예:
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의 유효한 설정 및 각 값이 광고 게재에 미치는 영향은 다음과 같습니다.
기본적으로 adsafe는 높음으로 설정됩니다. 예시: 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest
|
선택사항 adtest 매개변수는 광고 요청이 테스트임을 나타내는 데 사용됩니다. adtest 매개변수 값이 on인 경우 Google에서는 요청을 테스트로 간주하며 광고 노출수를 계산하거나 클릭연결 결과를 추적하지 않습니다. adtest 매개변수 값이 on인 경우 수익이 발생하지 않습니다. 이 매개변수는 테스트에는 사용할 수 있지만 프로덕션 시스템에서는 사용하지 마세요. 사용할 경우 게재되는 광고에 대한 수익금이 지급되지 않습니다. adtest의 기본값은 사용 안함입니다. 예: 'adtest' : 'on' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
channel
|
선택사항 여러 페이지의 실적을 추적하기 위해 검색용 애드센스 채널을 포함할 수 있습니다. 애드센스 계정이나 기술 계정 관리자가 만든 고유한 채널 ID를 사용하세요. 여기에서 채널에 대해 자세히 알아보세요. 여러 채널을 사용할 경우 '+' 기호로 구분해야 합니다. 예: 'channel' : 'testA' 'channel' : 'testA+testB' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
hl
|
선택 이 매개변수는 요청된 광고 또는 관련 검색어가 타겟팅해야 하는 언어를 식별합니다. 기본값은 en입니다. Google에서는 모든 애드워즈 API 언어 코드를 지원합니다. 참고: 광고가 타겟팅하는 언어는 광고주가 지정합니다. 요청에 이 매개변수를 포함하면 해당 언어를 타겟팅하거나 모든 언어를 타겟팅하는 광고만 게재됩니다. 단, 광고문안이 지정된 언어로 표시되지 않을 수도 있습니다. 일반적으로 hl 매개변수를 이 매개변수를 보낸 페이지의 기본 언어로 설정해야 합니다. 예: 'hl' : 'es' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
ie
|
선택사항
기본
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe
|
선택사항
기본
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
ivt
|
선택사항 이 매개변수를 사용하면 동의한 트래픽과 동의하지 않은 트래픽 모두에서 무효 트래픽 전용 쿠키 및 로컬 스토리지를 사용하는 광고를 허용할 것임을 Google에 알리는 불리언을 제공할 수 있습니다.
기본적으로 IVT는 true로 설정됩니다. 예시: 'ivt': false |
단위 수준 매개변수에 관한 설명
이러한 매개변수는 페이지의 개별 광고 단위가 사용자에게 표시되는 방식에 영향을 줍니다. 각 매개변수는 광고 단위별로 개별적으로 설정할 수 있습니다.
필수
| 매개변수 | 설명 및 예 |
|---|---|
container
|
필수 광고가 게재될 빈 광고 컨테이너 <div>의 ID입니다.
예시: 'container' : 'afscontainer1' |
maxTop
|
광고 단위가 검색결과 위에 있는 경우 필수사항입니다. 이 매개변수를 사용하여 상단 광고 단위에 게재할 광고의 수를 지정합니다. 참고: 이 매개변수는 'number' 매개변수 대신 사용됩니다. 이 광고 단위는 광고의 첫 번째 줄이 줄바꿈되지 않도록 너비가 충분해야 합니다. 페이지의 다른 게재위치에 maxTop 매개변수를 사용하는 것은 정책 위반입니다. 예: 'maxTop' : 4 |
width
|
필수 광고 또는 관련 검색어 단위의 너비를 픽셀 단위로 지정합니다. 예: 'width' : '700px' 'width' : 700 |
구성 설정
| 매개변수 | 설명 및 예 | ||||||||
|---|---|---|---|---|---|---|---|---|---|
adLoadedCallback
|
선택 광고 또는 관련 검색어가 로드되었거나 광고 또는 관련 검색어가 게재되지 않을 때 호출할 자바스크립트 함수를 지정합니다. 이 매개변수는 광고 호출이 완료될 때 작업을 실행할 수 있도록 구현하는 자바스크립트 콜백 함수로 설정해야 합니다. 콜백 함수는 다음 매개변수를 사용합니다.
참고: 콜백 함수를 테스트하여 오류가 발생하지 않는지 확인하세요. 특히 페이지 로드를 방해할 수 있는 오류가 발생하지 않는지 확인하세요. 자바스크립트 콜백의 예:
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 |