내 애드센스 페이지에서 애드센스를 성공적으로 활용하는 데 도움이 될 계정 관련 맞춤 정보를 확인하세요.

검색용 애드센스(AFS)

맞춤 검색 광고 매개변수 설명

고급 사용자를 위해 현재 지원되는 맞춤 검색 스타일 매개변수 목록을 제공합니다. 애드센스에서 생성하는 코드에는 가장 일반적으로 사용되는 매개변수 설정이 모두 포함됩니다. 필수 매개변수에는 pubIdquery 두 가지가 있습니다. 애드센스에서 pubId를 제공하지만 코드를 수정하고 query 매개변수의 값을 전달해야 합니다. 다른 매개변수는 모두 선택사항이며 아래에 설명되어 있습니다.

매개변수 유형

매개변수에는 두 가지 유형이 있습니다.

다음은 광고 블록 두 개를 사용한 코드 생성기의 출력 예입니다. 이 코드를 구성하려면 pageOptions 맵에 필수 query 매개변수를 설정해야 합니다(예: “query”: myQuery). 이렇게 하면 광고 게재를 시작할 수 있습니다. 페이지 수준 블록에 선택적으로 페이지 수준 매개변수를 설정하고 adblock1adblock2 맵에 개별 단위 수준 매개변수를 설정할 수도 있습니다.

<div id="afscontainer1"></div>
<div id="afscontainer2"></div>

<script type="text/javascript" charset="utf-8">

  // 페이지 수준 매개변수
  var pageOptions = {
    "pubId": "partner-pub-1234567891234567",
    "styleId": "1234567890",
    "query": myQuery,
  };

  // 광고 단위 수준 매개변수
  var adblock1 = {
    "container": "afscontainer1"
  };

  var adblock2 = {
    "container": "afscontainer2"
  };

  _googCsa('ads', pageOptions, adblock1, adblock2);

</script>

페이지 수준 매개변수 설명

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

필수

매개변수 설명 및 예시
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는 검색어가 포함된 자바스크립트 변수입니다.

구성 설정(선택사항)

매개변수 설명 및 예시
adPage 선택사항

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

adsafe 선택사항
Google에서 검색어와 일치하는 광고에 적용해야 하는 필터링 규칙을 지정합니다. adsafe의 유효한 설정 및 각 값이 광고 게재에 미치는 영향은 다음과 같습니다.
  • 'high'- 가족용 광고를 게재합니다. 비가족용 광고나 성인용 광고는 게재하지 않습니다.
  • 'medium'- 가족용 광고와 비가족용 광고를 게재합니다. 성인용 광고는 게재하지 않습니다.
  • 'low'- 모든 유형의 광고를 게재합니다.
기본적으로 adsafe는 'high'로 설정됩니다.

예:

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

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

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

adtest의 기본값은 'off'입니다.

예:

'adtest' : 'on'
channel 선택사항
여러 페이지의 실적을 추적하기 위해 검색용 애드센스 채널을 포함할 수 있습니다. 애드센스 계정에서 만든 고유 채널 ID를 사용하세요. 맞춤 채널을 통해 광고 실적을 추적하는 방법에 대해 자세히 알아보세요.

여러 채널을 사용할 경우 '+' 기호로 구분해야 합니다.
 

예:

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

Google에서는 Google Ads 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  
greek ISO-8859-7 그리스어
hebrew 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'입니다. 가능한 값의 전체 목록은 ie 매개변수를 참조하세요.

personalizedAds 선택사항
게시자가 개인 맞춤 광고를 목적으로 Google과 개인정보를 공유하는 데 사용자가 동의했는지 여부를 지정합니다.
  • true 검색어 타겟팅 광고와 사용자의 Google 쿠키를 사용하여 타겟팅할 수 있는 광고를 게재합니다. 사용자가 유럽 연합에 위치한 경우, 먼저 사이트에서 개인 맞춤 광고를 목적으로 Google과 개인정보를 공유하는 데 사용자의 동의가 있어야 합니다.
  • false 검색어 타겟팅 광고만 게재합니다. 사용자의 Google 쿠키를 사용하여 타겟팅하는 광고는 개재하지 않습니다. 사용자가 사이트에서 개인 맞춤 광고를 목적으로 Google과 개인정보를 공유하는 데 동의하지 않은 경우 이 값을 false로 설정해야 합니다.
기본적으로 personalizedAds는 'true'로 설정됩니다.

예:

'personalizedAds': false

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

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

필수

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

예:

'container' : 'afscontainer1'

구성 설정(선택사항)

매개변수 설명 및 예시
maxTop 선택사항

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

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

예:

'maxTop' : 4
number 선택사항
이 광고 단위에 게재할 광고의 수입니다. 기본값은 '2'입니다.

예:

'number' : 4
width 필수
광고 단위의 너비를 픽셀 단위로 지정합니다.

예:

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

도움이 더 필요하신가요?

로그인하여 추가 지원 옵션으로 문제를 빠르게 해결하세요.

검색
검색어 지우기
검색 닫기
Google 앱
기본 메뉴
도움말 센터 검색
true
157
false