애드센스에서는 고급 사용자를 위해 현재 지원되는 검색 스타일 매개변수 목록을 제공합니다. 애드센스에서 생성하는 코드에는 흔히 사용되는 매개변수 설정이 모두 포함됩니다. 필수 매개변수는 pubId
와 query
의 두 가지가 있습니다. 애드센스에서 pubId를 제공하기는 하지만 코드를 수정하고 query
매개변수의 값을 전달하는 것은 게시자가 직접 해야 합니다. 다른 매개변수는 모두 선택사항이며 아래에 설명되어 있습니다.
매개변수 유형
매개변수에는 두 가지 유형이 있습니다.
- 페이지 수준 매개변수: 페이지의 모든 광고 단위에 적용됩니다.
- 광고 단위 수준 매개변수: 개별 광고 단위에 적용됩니다.
다음은 광고 블록 두 개를 사용한 코드 생성기의 출력 예입니다. 이 코드를 구성하려면 pageOptions
맵에 필수 query
매개변수를 설정해야 합니다(예: “query”: myQuery
). 이렇게 하면 광고 게재를 시작할 수 있습니다. 페이지 수준 블록에 선택적으로 페이지 수준 매개변수를 설정하고 adblock1
및 adblock2
맵에 개별 단위 수준 매개변수를 설정할 수도 있습니다.
<div id="afscontainer2"></div>
<script type="text/javascript" charset="utf-8">
// Page level parameters
var pageOptions = {
"pubId": "partner-pub-1234567891234567",
"styleId": "1234567890",
"query": myQuery,
};
// Unit level parameters
var adblock1 = {
"container": "afscontainer1"
};
var adblock2 = {
"container": "afscontainer2"
};
_googCsa('ads', pageOptions, adblock1, adblock2);
</script>
페이지 수준 매개변수 설명
이 매개변수는 페이지당 한 번만 지정하면 되며, 페이지의 모든 광고 단위에 영향을 미칩니다.
필수
매개변수 | 설명 및 예시 |
---|---|
adPage |
사용자가 다음 결과 페이지 또는 이전 결과 페이지로 이동할 때 필요합니다.
|
pubId |
필수 애드센스 client-ID입니다. pubId는 client-ID에서 'partner-' 뒤에 나오는 부분입니다. 예를 들어 client-ID가 'partner-test-property'인 경우 pubId는 'test-property'입니다. 이는 CSA의 표준 프로토콜입니다. 예시: 'pubId' : 'test-property' |
query |
필수 사용자가 입력하는 검색어입니다. query 매개변수의 값은 인코딩되지 않아야 합니다. 예시:
|
resultsPageBaseUrl |
페이지에 관련 검색어 단위가 있는 경우 필수 사용자가 클릭한 관련 검색어가 검색 쿼리인 경우 해당 검색결과 페이지의 URL을 지정합니다. resultsPageBaseUrl 은 자동으로 추가되는 검색어를 제외하고 자체 매개변수를 포함할 수 있습니다.
예시:
|
styleId |
필수 페이지의 광고 또는 관련 검색어 단위에 적용할 검색 스타일의 ID를 지정합니다. 검색 스타일 사용에 대해 자세히 알아보세요. 요청에 대해 styleId가 설정된 경우, 광고 또는 관련 검색어가 스타일과 함께 렌더링되며 기존 스타일 지정 매개변수는 무시됩니다. 요청에서 styleId가 지정되지 않은 경우 시스템 기본 스타일이 렌더링됩니다. 예시
|
선택
매개변수 | 설명 및 예시 |
---|---|
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' |
구성 설정
매개변수 | 설명 및 예시 | |||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
adsafe |
선택 검색어와 일치하는 광고에 Google이 적용해야 하는 필터링 규칙을 지정합니다. adsafe 의 유효한 설정 및 각 값이 광고 게재에 미치는 영향은 다음과 같습니다.
참고: 기본적으로
adsafe 는 'high'로 설정됩니다.예시: 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest |
선택adtest 매개변수는 광고 요청이 테스트임을 나타내는 데 사용됩니다. adtest 매개변수의 값이 'on'이면 Google에서는 요청을 테스트로 간주하고 광고 노출수로 계산하거나 클릭 결과를 추적하지 않습니다.
참고: 이 매개변수를 테스트 용도가 아닌 실제 광고 서비스에 이용할 경우 광고 게재에 따른 수익이 지급되지 않습니다.
adtest의 기본값은 'off'입니다. 예시: 'adtest' : 'on' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
channel |
선택 여러 페이지의 실적을 추적하기 위해 검색용 애드센스 채널을 포함할 수 있습니다. 애드센스 계정에서 만든 고유 채널 ID를 사용합니다. 맞춤 채널을 통해 광고 실적을 추적하는 방법에 대해 자세히 알아보세요. 여러 채널을 사용할 경우 '+' 기호로 구분해야 합니다. 예시: 'channel' : 'testA' 'channel' : 'testA+testB' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
hl |
선택 요청된 광고가 타겟팅할 언어를 나타냅니다. 기본값은 'en'입니다. Google에서는 Google Ads API 언어 코드를 모두 지원합니다. 참고: 광고주는 자신의 광고가 타겟팅하는 언어를 지정합니다. 게시자가 요청에 이 매개변수를 포함하면 해당 언어를 타겟팅하거나 모든 언어를 타겟팅하는 광고만 게재됩니다. 단, 광고문안이 지정된 언어로 표시되지 않을 수도 있습니다.
일반적으로 예시: 'hl' : 'es' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
ie |
선택
기본
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe |
선택
기본
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
personalizedAds |
선택 게시자가 개인 맞춤 광고를 목적으로 Google과 개인 정보를 공유하는 데 사용자가 동의했는지 여부를 지정합니다.
참고: 기본적으로
personalizedAds 는 'true'로 설정됩니다.예시: 'personalizedAds': false |
광고 단위 수준 매개변수 설명
페이지의 각 광고 단위가 사용자에게 게재되는 방식에 영향을 주는 매개변수입니다. 광고 단위마다 매개변수를 개별적으로 설정할 수 있습니다.
필수
매개변수 | 설명 및 예시 |
---|---|
container |
필수 광고가 게재될 빈 광고 컨테이너 <div id='afscontainer1'></div> 의 ID입니다.
예시:
|
maxTop |
필수
상단 광고 단위에 게재될 광고 수를 지정하려면 이 매개 변수를 사용하세요. 참고: 이 매개변수는
number 매개변수 대신 사용됩니다. 이 광고 단위는 광고의 첫 번째 줄이 줄바꿈되지 않도록 폭이 충분히 넓어야 합니다. 페이지의 다른 게재위치에 maxTop 매개변수를 사용하는 것은 정책 위반입니다.예시:
|
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'입니다. 예시:
|
||||||||
relatedSearches |
선택 광고 단위에 표시할 관련 검색어의 수입니다. 이 매개변수는 0으로 설정하지 않는 한 최소 3개의 관련 검색어를 반환합니다. 지정하지 않을 경우 기본값은 0입니다. 예시: 'relatedSearches' : 4 |