GPT 참조

이 참조에서는 TypeScript 표기법을 사용하여 유형을 설명합니다. 다음 표에는 예시별로 간단한 설명이 나와 있습니다.

유형 표현식
string	기본 문자열 유형입니다.
string[]	배열 유형. 값이 문자열만 될 수 있습니다.
number | string	유니온 유형(값이 숫자 또는 문자열일 수 있음)
Array<number | string>	값이 복합 (공용체) 유형인 배열 유형입니다.
[number, string]	튜플 유형. 여기서 값은 숫자와 문자열을 순서대로 포함해야 하는 두 요소 배열입니다.
Slot	값이 googletag.Slot의 인스턴스인 객체 유형.
() => void	정의된 인수와 반환 값이 없는 함수 유형입니다.

지원되는 유형 및 유형 표현식에 대한 자세한 내용은 TypeScript 핸드북 을 참조하세요.

형식 주석

변수, 매개변수 이름, 속성 이름 또는 함수 서명 뒤의 콜론은 형식 주석을 나타냅니다. 형식 주석은 콜론 왼쪽에 있는 요소가 허용하거나 반환할 수 있는 유형을 설명합니다. 다음 표는 이 참조에서 볼 수 있는 유형 주석의 예를 보여줍니다.

유형 주석
param: string	param가 문자열 값을 수락하거나 반환함을 나타냅니다. 이 구문은 변수, 매개변수, 속성, 반환 유형에 사용됩니다.
param?: number | string	param가 선택사항임을 나타내지만 지정되면 숫자 또는 문자열을 허용합니다. 이 구문은 매개변수 및 속성에 사용됩니다.
...params: Array<() => void>	params가 함수를 허용하는 휴식 매개변수 임을 나타냅니다. 나머지 매개변수는 지정된 유형의 값을 무제한으로 허용합니다.

---

유형 정의

유형
googletag.GeneralSize	SingleSize | MultiSize
슬롯의 유효한 크기 구성으로, 크기가 하나이거나 여러 개일 수 있습니다.
googletag.MultiSize	SingleSize[]
유효한 단일 크기의 목록입니다.
googletag.NamedSize	"fluid" | ["fluid"]
슬롯에 있을 수 있는 이름이 지정된 크기입니다. 대부분의 경우 크기는 고정된 크기의 직사각형이지만 다른 종류의 크기 사양이 필요한 경우도 있습니다. 다음만 유효한 이름이 지정된 크기입니다. fluid: 광고 컨테이너가 상위 div의 너비를 100% 로 설정한 다음 광고 소재 콘텐츠에 맞게 높이를 조정합니다. 페이지의 일반적인 블록 요소가 작동하는 방식과 유사합니다. 네이티브 광고에 사용됩니다 (관련 도움말 참고). fluid와 ['fluid'] 모두 슬롯 크기를 유동적으로 선언할 수 있는 형식입니다.
googletag.SingleSize	SingleSizeArray | NamedSize
슬롯의 유효한 단일 크기입니다.
googletag.SingleSizeArray	[number, number]
[너비, 높이]를 나타내는 두 숫자의 배열입니다.
googletag.SizeMapping	[SingleSizeArray, GeneralSize]
표시 영역 크기를 광고 크기에 매핑한 것입니다. 반응형 광고에 사용됩니다.
googletag.SizeMappingArray	SizeMapping[]
크기 매핑 목록입니다.
googletag.config.InterstitialTrigger	"unhideWindow" | "navBar"
지원되는 전면 광고 트리거
googletag.config.PrivacyTreatment	"disablePersonalization"
게시자 개인 정보 보호 처리가 지원됩니다.
googletag.config.Taxonomy	"IAB_AUDIENCE_1_1" | "IAB_CONTENT_2_2"
게시자 제공 신호 (PPS)에 지원되는 분류입니다.
googletag.secureSignals.SecureSignalProvider	BidderSignalProvider | PublisherSignalProvider
특정 입찰자 또는 제공업체의 보안 신호를 반환하기 위한 인터페이스입니다. id 또는 networkCode 중 하나만 입력해야 합니다.

enum 유형

열거형
googletag.enums.OutOfPageFormat	GPT에서 지원하는 페이지 외부 형식입니다.
googletag.enums.TrafficSource	GPT에서 지원하는 트래픽 소스입니다.

---

googletag.enums.OutOfPageFormat

• GPT에서 지원하는 페이지 외부 형식입니다.

• 참고 항목

  • defineOutOfPageSlot

• 값
  BOTTOM_ANCHOR	슬롯이 표시 영역의 하단에 고정되는 앵커 형식입니다.
  INTERSTITIAL	웹 전면 광고 소재 형식
  LEFT_SIDE_RAIL	왼쪽 사이드 레일 형식입니다.
  REWARDED	보상형 광고 형식입니다.
  RIGHT_SIDE_RAIL	오른쪽 사이드 레일 형식입니다.
  TOP_ANCHOR	슬롯이 표시 영역 상단에 고정되는 앵커 형식입니다.

---

googletag.enums.TrafficSource

• GPT에서 지원하는 트래픽 소스입니다.

• 참고 항목

  • PrivacySettingsConfig.trafficSource

• 값
  ORGANIC	직접 URL 입력, 사이트 검색 또는 앱 다운로드
  PURCHASED	소유가 아닌 속성 (획득 또는 인센티브 제공 활동)에서 리디렉션된 트래픽입니다.

---

googletag

Google 게시자 태그에서 API에 사용하는 전역 네임스페이스입니다.

변수 요약
apiReady	GPT API가 로드되어 호출할 준비가 되었음을 나타내는 플래그입니다.
cmd	GPT 관련 호출의 비동기 실행을 위한 전역 명령 대기열에 대한 참조입니다.
pubadsReady	PubAdsService가 사용 설정 및 로드되었으며 완전히 작동함을 나타내는 플래그입니다.
secureSignalProviders	보안 신호 제공자 배열에 대한 참조입니다.

함수 요약
companionAds	CompanionAdsService 참조를 반환합니다.
defineOutOfPageSlot	지정된 광고 단위 경로를 사용하여 페이지 외부 광고 슬롯을 생성합니다.
defineSlot	지정된 광고 단위 경로 및 크기를 가진 광고 슬롯을 만들어 광고가 포함될 페이지의 div 엘리먼트 ID와 연결합니다.
destroySlots	주어진 슬롯을 제거하여 GPT에서 해당 슬롯의 모든 관련 개체와 참조를 제거합니다.
disablePublisherConsole	Google 게시자 콘솔을 사용 중지합니다.
display	슬롯 서비스가 슬롯을 렌더링하도록 지시합니다.
enableServices	페이지의 광고 슬롯에 정의된 모든 GPT 서비스를 사용 설정합니다.
getVersion	GPT의 현재 버전을 반환합니다.
openConsole	Google 게시자 콘솔을 엽니다.
pubads	PubAdsService 참조를 반환합니다.
setAdIframeTitle	이 시점부터 PubAdsService에서 만든 모든 광고 컨테이너 iframe의 제목을 설정합니다.
setConfig	페이지의 일반 구성 옵션을 설정합니다.
sizeMapping	새 SizeMappingBuilder를 만듭니다.

---

googletagapiReady

• apiReady: boolean | undefined

• GPT API가 로드되어 호출할 준비가 되었음을 나타내는 플래그입니다. API가 준비될 때까지 이 속성은 단순히 undefined 상태가 됩니다.
  
  비동기를 처리할 때는 googletag.cmd를 사용하여 GPT가 준비되었을 때 콜백을 대기열에 추가하는 것이 좋습니다. 이러한 콜백은 API가 설정되면 실행이 보장되므로 googletag.apiReady를 확인하지 않아도 됩니다.

• 예

  JavaScript

  if (window.googletag && googletag.apiReady) {
    // GPT API can be called safely.
  }
  

  자바스크립트 (기존)

  if (window.googletag && googletag.apiReady) {
    // GPT API can be called safely.
  }
  

  TypeScript

  if (window.googletag && googletag.apiReady) {
    // GPT API can be called safely.
  }
  

---

googletagcmd

• cmd: Array<(this: typeof globalThis) => void> | CommandArray

• GPT 관련 호출의 비동기 실행을 위한 전역 명령어 대기열에 대한 참조입니다.
  
  googletag.cmd 변수는 페이지의 GPT 태그 구문에 의해 빈 자바스크립트 배열로 초기화되며 cmd.push는 요소를 배열 끝에 추가하는 표준 Array.push 메서드입니다. GPT 자바스크립트가 로드되면 배열을 살펴보고 모든 함수를 순서대로 실행합니다. 그런 다음 스크립트는 cmd를 전달된 함수 인수를 실행하도록 정의된 푸시 메서드가 있는 CommandArray 객체로 대체합니다. 이 메커니즘을 사용하면 브라우저가 계속해서 페이지를 렌더링하도록 허용하면서 GPT가 자바스크립트를 비동기적으로 가져와서 체감 지연 시간을 줄일 수 있습니다.

• 예

  JavaScript

  googletag.cmd.push(() => {
    googletag.defineSlot("/1234567/sports", [160, 600]).addService(googletag.pubads());
  });
  

  자바스크립트 (기존)

  googletag.cmd.push(function () {
    googletag.defineSlot("/1234567/sports", [160, 600]).addService(googletag.pubads());
  });
  

  TypeScript

  googletag.cmd.push(() => {
    googletag.defineSlot("/1234567/sports", [160, 600])!.addService(googletag.pubads());
  });
  

---

googletagpubadsReady

• pubadsReady: boolean | undefined

• PubAdsService가 사용 설정 및 로드되었으며 완전히 작동함을 나타내는 플래그입니다. enableServices가 호출되고 PubAdsService가 로드 및 초기화될 때까지 이 속성은 단순히 undefined입니다.

---

googletagsecureSignalProviders

• secureSignalProviders: SecureSignalProvider[] | SecureSignalProvidersArray | undefined

• 보안 신호 제공업체 배열에 대한 참조입니다.
  
  보안 신호 제공업체 배열은 일련의 신호 생성 함수를 받아 순서대로 호출합니다. 이는 GPT가 로드되면 호출할 신호 생성 함수를 대기열에 추가하는 데 사용되는 표준 배열을 대체하기 위한 것입니다.

• 예

  JavaScript

  window.googletag = window.googletag || { cmd: [] };
  googletag.secureSignalProviders = googletag.secureSignalProviders || [];
  googletag.secureSignalProviders.push({
    id: "collector123",
    collectorFunction: () => {
      return Promise.resolve("signal");
    },
  });
  

  자바스크립트 (기존)

  window.googletag = window.googletag || { cmd: [] };
  googletag.secureSignalProviders = googletag.secureSignalProviders || [];
  googletag.secureSignalProviders.push({
    id: "collector123",
    collectorFunction: function () {
      return Promise.resolve("signal");
    },
  });
  

  TypeScript

  window.googletag = window.googletag || { cmd: [] };
  googletag.secureSignalProviders = googletag.secureSignalProviders || [];
  googletag.secureSignalProviders.push({
    id: "collector123",
    collectorFunction: () => {
      return Promise.resolve("signal");
    },
  });
  

  참고 항목

  • 입찰자와 보안 처리된 신호 공유

---

googletagcompanionAds

• companionAds(): CompanionAdsService

• CompanionAdsService 참조를 반환합니다.

• 반환 값
  CompanionAdsService	컴패니언 광고 서비스

---

googletagdefineOutOfPageSlot

• defineOutOfPageSlot(adUnitPath: string, div?: string | OutOfPageFormat): Slot | null

• 지정된 광고 단위 경로를 사용하여 페이지 외부 광고 슬롯을 만듭니다.
  
  맞춤 페이지 외부 광고의 경우 div는 광고가 포함될 div 엘리먼트의 ID입니다. 자세한 내용은 페이지 외부 광고 소재 도움말을 참조하세요.
  
  GPT 관리 페이지 외부 광고의 경우 div가 지원되는 OutOfPageFormat입니다.

• 예

  JavaScript

  // Define a custom out-of-page ad slot.
  googletag.defineOutOfPageSlot("/1234567/sports", "div-1");
  
  // Define a GPT managed web interstitial ad slot.
  googletag.defineOutOfPageSlot("/1234567/sports", googletag.enums.OutOfPageFormat.INTERSTITIAL);
  

  자바스크립트 (기존)

  // Define a custom out-of-page ad slot.
  googletag.defineOutOfPageSlot("/1234567/sports", "div-1");
  
  // Define a GPT managed web interstitial ad slot.
  googletag.defineOutOfPageSlot("/1234567/sports", googletag.enums.OutOfPageFormat.INTERSTITIAL);
  

  TypeScript

  // Define a custom out-of-page ad slot.
  googletag.defineOutOfPageSlot("/1234567/sports", "div-1");
  
  // Define a GPT managed web interstitial ad slot.
  googletag.defineOutOfPageSlot("/1234567/sports", googletag.enums.OutOfPageFormat.INTERSTITIAL);
  

  참고 항목

  • 보상형 광고 표시
  • 웹 전면 광고 표시
  • 앵커 광고 표시하기
  • 페이지 외부 광고 표시

• 매개변수
  adUnitPath: string	네트워크 코드와 광고 단위 코드가 있는 전체 광고 단위 경로
  div?: string | OutOfPageFormat	이 광고 단위 또는 OutOfPageFormat이 포함될 div의 ID입니다.

• 반환 값
  Slot | null	새로 생성된 슬롯 또는 슬롯을 만들 수 없는 경우 null입니다.

---

googletagdefineSlot

• defineSlot(adUnitPath: string, size: GeneralSize, div?: string): Slot | null

• 지정된 광고 단위 경로 및 크기를 가진 광고 슬롯을 만들어 광고가 포함될 페이지의 div 엘리먼트 ID와 연결합니다.

• 예

  JavaScript

  googletag.defineSlot("/1234567/sports", [728, 90], "div-1");
  

  자바스크립트 (기존)

  googletag.defineSlot("/1234567/sports", [728, 90], "div-1");
  

  TypeScript

  googletag.defineSlot("/1234567/sports", [728, 90], "div-1");
  

  참고 항목

  • Google 게시자 태그 시작하기

• 매개변수
  adUnitPath: string	네트워크 코드와 단위 코드가 있는 전체 광고 단위 경로
  size: GeneralSize	추가된 슬롯의 너비 및 높이입니다. 반응형 크기 매핑이 제공되지 않았거나 표시 영역의 크기가 매핑에 제공된 최소 크기보다 작은 경우 광고 요청에 사용되는 크기입니다.
  div?: string	이 광고 단위가 포함될 div의 ID입니다.

• 반환 값
  Slot | null	새로 생성된 슬롯 또는 슬롯을 만들 수 없는 경우 null입니다.

---

googletagdestroySlots

• destroySlots(slots?: Slot[]): boolean

• 주어진 슬롯을 제거하여 GPT에서 해당 슬롯의 모든 관련 개체와 참조를 제거합니다. 이 API는 패스백 슬롯 및 컴패니언 슬롯을 지원하지 않습니다.
  
  슬롯에서 이 API를 호출하면 광고가 삭제되고 GPT에서 관리하는 내부 상태에서 슬롯 객체가 삭제됩니다. 슬롯 객체에서 함수를 더 호출하면 정의되지 않은 동작이 발생합니다. 게시자 페이지에서 해당 슬롯에 대한 참조를 유지 관리하는 경우 브라우저에서 여전히 슬롯과 관련된 메모리를 확보하지 못할 수 있습니다. 이 API를 호출하면 해당 슬롯과 연결된 div를 재사용할 수 있습니다.
  
  특히 슬롯을 삭제하면 GPT의 오래 지속되는 페이지 조회에서 광고가 삭제되므로 향후 요청이 이 광고와 관련된 로드블록이나 경쟁 제외의 영향을 받지 않습니다. 페이지에서 슬롯의 div를 제거하기 전에 이 함수를 호출하지 않으면 정의되지 않은 동작이 발생합니다.

• 예

  JavaScript

  // The calls to construct an ad and display contents.
  const slot1 = googletag.defineSlot("/1234567/sports", [728, 90], "div-1");
  googletag.display("div-1");
  const slot2 = googletag.defineSlot("/1234567/news", [160, 600], "div-2");
  googletag.display("div-2");
  
  // This call to destroy only slot1.
  googletag.destroySlots([slot1]);
  
  // This call to destroy both slot1 and slot2.
  googletag.destroySlots([slot1, slot2]);
  
  // This call to destroy all slots.
  googletag.destroySlots();
  

  자바스크립트 (기존)

  // The calls to construct an ad and display contents.
  var slot1 = googletag.defineSlot("/1234567/sports", [728, 90], "div-1");
  googletag.display("div-1");
  var slot2 = googletag.defineSlot("/1234567/news", [160, 600], "div-2");
  googletag.display("div-2");
  
  // This call to destroy only slot1.
  googletag.destroySlots([slot1]);
  
  // This call to destroy both slot1 and slot2.
  googletag.destroySlots([slot1, slot2]);
  
  // This call to destroy all slots.
  googletag.destroySlots();
  

  TypeScript

  // The calls to construct an ad and display contents.
  const slot1 = googletag.defineSlot("/1234567/sports", [728, 90], "div-1")!;
  googletag.display("div-1");
  const slot2 = googletag.defineSlot("/1234567/news", [160, 600], "div-2")!;
  googletag.display("div-2");
  
  // This call to destroy only slot1.
  googletag.destroySlots([slot1]);
  
  // This call to destroy both slot1 and slot2.
  googletag.destroySlots([slot1, slot2]);
  
  // This call to destroy all slots.
  googletag.destroySlots();
  

• 매개변수
  slots?: Slot[]	제거할 슬롯 배열입니다. 배열은 선택사항입니다. 지정하지 않으면 모든 슬롯이 소멸됩니다.

• 반환 값
  boolean	슬롯이 소멸된 경우 true, 소멸되지 않은 경우 false

---

googletagdisablePublisherConsole

• disablePublisherConsole(): void

• Google 게시자 콘솔을 사용 중지합니다.

• 참고 항목

  • Google 게시자 콘솔

---

googletagdisplay

• display(divOrSlot: string | Element | Slot): void

• 슬롯 서비스가 슬롯을 렌더링하도록 지시합니다. 각 광고 슬롯은 페이지당 한 번만 게재됩니다. 모든 슬롯은 정의되고 연결된 서비스가 있어야 게재됩니다. 표시 호출은 요소가 DOM에 나타날 때까지 발생해서는 안 됩니다. 이렇게 하는 일반적인 방법은 메서드 호출에서 이름이 지정된 div 요소 내의 스크립트 블록 내에 배치하는 것입니다.
  
  단일 요청 아키텍처 (SRA)를 사용 중인 경우 이 메서드가 호출될 때 가져오지 않은 모든 광고 슬롯을 한 번에 가져옵니다. 광고 슬롯이 표시되지 않도록 하려면 전체 div를 삭제해야 합니다.

• 예

  JavaScript

  googletag.cmd.push(() => {
    googletag.display("div-1");
  });
  

  자바스크립트 (기존)

  googletag.cmd.push(function () {
    googletag.display("div-1");
  });
  

  TypeScript

  googletag.cmd.push(() => {
    googletag.display("div-1");
  });
  

  참고 항목

  • Google 게시자 태그 시작하기
  • 테스트 광고 게재하기
  • 광고 로드 및 새로고침 관리하기

• 매개변수
  divOrSlot: string | Element | Slot	광고 슬롯, div 요소 또는 슬롯 개체가 포함된 div 요소의 ID입니다. div 요소가 제공된 경우 defineSlot에 전달된 ID와 일치하는 'id' 속성이 있어야 합니다.

---

googletagenableServices

• enableServices(): void

• 페이지의 광고 슬롯에 정의된 모든 GPT 서비스를 사용 설정합니다.

---

googletaggetVersion

• getVersion(): string

• GPT의 현재 버전을 반환합니다.

• 참고 항목

  • GPT 버전 기록

• 반환 값
  string	현재 실행 중인 GPT 버전 문자열입니다.

---

googletagopenConsole

• openConsole(div?: string): void

• Google 게시자 콘솔을 엽니다.

• 예

  JavaScript

  // Calling with div ID.
  googletag.openConsole("div-1");
  
  // Calling without div ID.
  googletag.openConsole();
  

  자바스크립트 (기존)

  // Calling with div ID.
  googletag.openConsole("div-1");
  
  // Calling without div ID.
  googletag.openConsole();
  

  TypeScript

  // Calling with div ID.
  googletag.openConsole("div-1");
  
  // Calling without div ID.
  googletag.openConsole();
  

  참고 항목

  • Google 게시자 콘솔

• 매개변수
  div?: string	광고 슬롯 div ID입니다. 이 값은 선택사항입니다. 제공된 경우 게시자 콘솔은 지정된 광고 슬롯의 세부정보를 사용하여 열려고 시도합니다.

---

googletagpubads

• pubads(): PubAdsService

• PubAdsService 참조를 반환합니다.

• 반환 값
  PubAdsService	게시자 광고 서비스입니다.

---

googletagsetAdIframeTitle

• setAdIframeTitle(title: string): void

• 이 시점부터 PubAdsService에서 만든 모든 광고 컨테이너 iframe의 제목을 설정합니다.

• 예

  JavaScript

  googletag.setAdIframeTitle("title");
  

  자바스크립트 (기존)

  googletag.setAdIframeTitle("title");
  

  TypeScript

  googletag.setAdIframeTitle("title");
  

• 매개변수
  title: string	모든 광고 컨테이너 iframe의 새 제목입니다.

---

googletagsetConfig

• setConfig(config: PageSettingsConfig): void

• 페이지의 일반 구성 옵션을 설정합니다.

• 매개변수
  config: PageSettingsConfig

---

googletagsizeMapping

• sizeMapping(): SizeMappingBuilder

• 새 SizeMappingBuilder를 만듭니다.

• 참고 항목

  • 광고 크기: 반응형 광고

• 반환 값
  SizeMappingBuilder	새 빌더입니다.

---

googletagCommandArray

명령어 배열은 일련의 함수를 받아 순서대로 호출합니다. 이는 GPT가 로드된 후 호출할 함수를 대기열에 추가하는 데 사용되는 표준 배열을 대체하기 위한 것입니다.

메서드 요약
push	인수에 지정된 일련의 함수를 순서대로 실행합니다.

---

push

• push(...f: Array<(this: typeof globalThis) => void>): number

• 인수에 지정된 일련의 함수를 순서대로 실행합니다.

• 예

  JavaScript

  googletag.cmd.push(() => {
    googletag.defineSlot("/1234567/sports", [160, 600]).addService(googletag.pubads());
  });
  

  자바스크립트 (기존)

  googletag.cmd.push(function () {
    googletag.defineSlot("/1234567/sports", [160, 600]).addService(googletag.pubads());
  });
  

  TypeScript

  googletag.cmd.push(() => {
    googletag.defineSlot("/1234567/sports", [160, 600])!.addService(googletag.pubads());
  });
  

• 매개변수
  ...f: Array<(this: typeof globalThis) => void>	실행할 자바스크립트 함수입니다. 런타임 결합은 항상 globalThis입니다. 둘러싸고 있는 어휘 컨텍스트의 this 값을 유지하는 화살표 함수를 전달하는 것이 좋습니다.

• 반환 값
  number	지금까지 처리된 명령어 수 Array.push의 반환 값 (배열의 현재 길이)과 호환됩니다.

---

googletagCompanionAdsService

Service를 확장합니다.

컴패니언 광고 서비스입니다. 이 서비스는 동영상 광고에서 컴패니언 광고를 표시하는 데 사용됩니다.

메서드 요약
addEventListener	페이지에서 특정 GPT 이벤트가 발생할 때 자바스크립트 함수를 설정하고 호출할 수 있도록 하는 리스너를 등록합니다. googletag.Service.addEventListener에서 상속됨
getSlots	이 서비스와 연결된 슬롯 목록을 가져옵니다. googletag.Service.getSlots에서 상속됨
removeEventListener	이전에 등록된 리스너를 제거합니다. googletag.Service.removeEventListener에서 상속됨
setRefreshUnfilledSlots	채워지지 않은 컴패니언 슬롯을 자동으로 백필할지 여부를 설정합니다.

참고 항목

• 동영상 및 오디오용 컴패니언 광고

---

setRefreshUnfilledSlots

• setRefreshUnfilledSlots(value: boolean): void

• 채워지지 않은 컴패니언 슬롯을 자동으로 백필할지 여부를 설정합니다.
  
  이 메서드는 페이지의 전체 기간 동안 여러 번 호출하여 백업 광고를 켜거나 끌 수 있습니다. 또한 PubAdsService로 등록된 슬롯만 백필됩니다. 정책 제한으로 인해 이 메서드는 Ad Exchange 동영상이 게재될 때 빈 컴패니언 슬롯을 채우도록 설계되지 않았습니다.

• 예

  JavaScript

  googletag.companionAds().setRefreshUnfilledSlots(true);
  

  자바스크립트 (기존)

  googletag.companionAds().setRefreshUnfilledSlots(true);
  

  TypeScript

  googletag.companionAds().setRefreshUnfilledSlots(true);
  

• 매개변수
  value: boolean	true: 잔여 슬롯을 자동으로 백필하고 false: 잔여 슬롯을 변경하지 않고 그대로 둡니다.

---

googletagPrivacySettingsConfig

개인 정보 보호 설정의 구성 객체입니다.

속성 요약
childDirectedTreatment	페이지를 아동 대상 서비스로 취급해야 하는지 여부를 나타냅니다.
limitedAds	게시자의 규제 준수 요구사항을 지원하기 위해 제한적인 광고 모드로 게재를 실행할 수 있습니다.
nonPersonalizedAds	게시자의 규제 준수 요구사항을 지원하기 위해 개인 맞춤이 아닌 광고 모드로 게재를 사용 설정합니다.
restrictDataProcessing	게시자의 규제 준수 요구사항을 지원하기 위해 제한된 처리 모드에서 게재를 사용하도록 설정합니다.
trafficSource	요청이 구매한 트래픽인지 자연 트래픽을 나타내는지 여부를 나타냅니다.
underAgeOfConsent	광고 요청을 동의 연령 미만의 사용자로부터 오는 것으로 표시할지 여부를 나타냅니다.

참고 항목

• 개인 정보 보호 설정 구성하기

---

childDirectedTreatment

• childDirectedTreatment: null | boolean

• 페이지를 아동 대상 서비스로 취급해야 하는지 여부를 나타냅니다. 구성을 삭제하려면 null로 설정합니다.

---

limitedAds

• limitedAds: boolean

• 게시자의 규제 준수 요구사항을 지원하기 위해 제한적인 광고 모드로 게재를 실행할 수 있습니다. 사용 설정하면 GPT 라이브러리 자체를 쿠키가 없고 제한된 광고 URL에서 선택적으로 요청할 수 있습니다.

• 참고 항목

  • 제한적인 광고 표시

---

nonPersonalizedAds

• nonPersonalizedAds: boolean

• 게시자의 규제 준수 요구사항을 지원하기 위해 개인 맞춤이 아닌 광고 모드로 게재를 사용 설정합니다.

---

restrictDataProcessing

• restrictDataProcessing: boolean

• 게시자의 규제 준수 요구사항을 지원하기 위해 제한된 처리 모드에서 게재를 사용하도록 설정합니다.

---

trafficSource

• trafficSource: TrafficSource

• 요청이 구매한 트래픽인지 자연 트래픽을 나타내는지 여부를 나타냅니다. 이 값은 Ad Manager 보고의 트래픽 소스 측정기준을 채웁니다. 설정하지 않으면 보고에서 트래픽 소스의 기본값이 undefined로 설정됩니다.

• 예

  JavaScript

  // Indicate requests represent organic traffic.
  googletag.pubads().setPrivacySettings({
    trafficSource: googletag.enums.TrafficSource.ORGANIC,
  });
  
  // Indicate requests represent purchased traffic.
  googletag.pubads().setPrivacySettings({
    trafficSource: googletag.enums.TrafficSource.PURCHASED,
  });
  

  자바스크립트 (기존)

  // Indicate requests represent organic traffic.
  googletag.pubads().setPrivacySettings({
    trafficSource: googletag.enums.TrafficSource.ORGANIC,
  });
  
  // Indicate requests represent purchased traffic.
  googletag.pubads().setPrivacySettings({
    trafficSource: googletag.enums.TrafficSource.PURCHASED,
  });
  

  TypeScript

  // Indicate requests represent organic traffic.
  googletag.pubads().setPrivacySettings({
    trafficSource: googletag.enums.TrafficSource.ORGANIC,
  });
  
  // Indicate requests represent purchased traffic.
  googletag.pubads().setPrivacySettings({
    trafficSource: googletag.enums.TrafficSource.PURCHASED,
  });
  

---

underAgeOfConsent

• underAgeOfConsent: null | boolean

• 광고 요청을 동의 연령 미만의 사용자로부터 오는 것으로 표시할지 여부를 나타냅니다. 구성을 삭제하려면 null로 설정합니다.

---

googletagPubAdsService

Service를 확장합니다.

게시자 광고 서비스입니다. 이 서비스는 Google Ad Manager 계정에서 광고를 가져오고 표시하는 데 사용됩니다.

메서드 요약
addEventListener	페이지에서 특정 GPT 이벤트가 발생할 때 자바스크립트 함수를 설정하고 호출할 수 있도록 하는 리스너를 등록합니다. googletag.Service.addEventListener에서 상속됨
clear	지정된 슬롯에서 광고를 삭제하고 빈 콘텐츠로 대체합니다.
clearCategoryExclusions	페이지 수준 광고 카테고리 제외 라벨을 모두 지웁니다.
clearTargeting	특정 키 또는 모든 키의 맞춤 타겟팅 매개변수를 지웁니다.
collapseEmptyDivs	표시할 광고 콘텐츠가 없을 때 슬롯 div가 페이지의 공간을 차지하지 않도록 슬롯 div 축소를 사용 설정합니다.
disableInitialLoad	페이지 로드 시 광고 요청을 사용 중지하지만 PubAdsService.refresh 호출을 사용하여 광고를 요청할 수 있습니다.
display	지정된 광고 단위 경로와 크기를 가진 광고 슬롯을 생성하고 표시합니다.
enableLazyLoad	구성 개체에서 정의한 대로 GPT에서 지연 로드를 사용 설정합니다.
enableSingleRequest	여러 광고를 동시에 가져오는 단일 요청 모드를 사용합니다.
enableVideoAds	페이지에 동영상 광고가 표시될 것임을 GPT에 알립니다.
get	지정된 키와 연결된 애드센스 속성의 값을 반환합니다.
getAttributeKeys	이 서비스에 설정된 속성 키를 반환합니다.
getSlots	이 서비스와 연결된 슬롯 목록을 가져옵니다. googletag.Service.getSlots에서 상속됨
getTargeting	설정된 특정 맞춤 서비스 수준 타겟팅 매개변수를 반환합니다.
getTargetingKeys	설정된 모든 맞춤 서비스 수준 타겟팅 키의 목록을 반환합니다.
isInitialLoadDisabled	광고에 대한 초기 요청이 이전 PubAdsService.disableInitialLoad 호출로 인해 중지되었는지 여부를 반환합니다.
refresh	페이지의 특정 또는 모든 슬롯에 새 광고를 가져와 게재합니다.
removeEventListener	이전에 등록된 리스너를 제거합니다. googletag.Service.removeEventListener에서 상속됨
set	게시자 광고 서비스에서 모든 광고 슬롯에 적용되는 애드센스 속성의 값을 설정합니다.
setCategoryExclusion	지정된 라벨 이름에 대해 페이지 수준 광고 카테고리 제외를 설정합니다.
setCentering	광고의 가로 가운데 맞춤을 사용 설정하거나 사용 중지합니다.
setForceSafeFrame	SafeFrame 컨테이너를 사용하여 페이지의 모든 광고를 강제로 렌더링해야 하는지 여부를 구성합니다.
setLocation	광고 항목을 특정 위치로 지역 타겟팅할 수 있도록 웹사이트의 위치 정보를 전달합니다.
setPrivacySettings	config 객체를 사용하여 단일 API에서 모든 개인 정보 보호 설정을 구성할 수 있습니다.
setPublisherProvidedId	게시자 제공 ID의 값을 설정합니다.
setSafeFrameConfig	SafeFrame 구성에 대한 페이지 수준 환경설정을 설정합니다.
setTargeting	모든 게시자 광고 서비스 광고 슬롯에 적용되는 특정 키에 대해 맞춤 타겟팅 매개변수를 설정합니다.
setVideoContent	타겟팅 및 콘텐츠 제외를 위해 동영상 콘텐츠 정보가 광고 요청과 함께 전송되도록 설정합니다.
updateCorrelator	광고 요청과 함께 전송되는 상관자를 변경하여 효과적으로 새 페이지 조회를 시작합니다.

---

clear

• clear(slots?: Slot[]): boolean

• 지정된 슬롯에서 광고를 삭제하고 빈 콘텐츠로 대체합니다. 슬롯이 가져오지 않음으로 표시됩니다.
  
  특히 슬롯을 삭제하면 GPT의 오래 지속된 페이지 조회에서 광고가 삭제되므로 향후 요청이 이 광고와 관련된 로드블록이나 경쟁 제외의 영향을 받지 않습니다.

• 예

  JavaScript

  const slot1 = googletag.defineSlot("/1234567/sports", [728, 90], "div-1");
  googletag.display("div-1");
  const slot2 = googletag.defineSlot("/1234567/news", [160, 600], "div-2");
  googletag.display("div-2");
  
  // This call to clear only slot1.
  googletag.pubads().clear([slot1]);
  
  // This call to clear both slot1 and slot2.
  googletag.pubads().clear([slot1, slot2]);
  
  // This call to clear all slots.
  googletag.pubads().clear();
  

  자바스크립트 (기존)

  var slot1 = googletag.defineSlot("/1234567/sports", [728, 90], "div-1");
  googletag.display("div-1");
  var slot2 = googletag.defineSlot("/1234567/news", [160, 600], "div-2");
  googletag.display("div-2");
  
  // This call to clear only slot1.
  googletag.pubads().clear([slot1]);
  
  // This call to clear both slot1 and slot2.
  googletag.pubads().clear([slot1, slot2]);
  
  // This call to clear all slots.
  googletag.pubads().clear();
  

  TypeScript

  const slot1 = googletag.defineSlot("/1234567/sports", [728, 90], "div-1")!;
  googletag.display("div-1");
  const slot2 = googletag.defineSlot("/1234567/news", [160, 600], "div-2")!;
  googletag.display("div-2");
  
  // This call to clear only slot1.
  googletag.pubads().clear([slot1]);
  
  // This call to clear both slot1 and slot2.
  googletag.pubads().clear([slot1, slot2]);
  
  // This call to clear all slots.
  googletag.pubads().clear();
  

• 매개변수
  slots?: Slot[]	지울 슬롯의 배열입니다. 배열은 선택사항입니다. 지정하지 않으면 모든 슬롯이 지워집니다.

• 반환 값
  boolean	슬롯이 지워지면 true를 반환하고 그렇지 않으면 false를 반환합니다.

---

clearCategoryExclusions

• clearCategoryExclusions(): PubAdsService

• 페이지 수준 광고 카테고리 제외 라벨을 모두 지웁니다. 슬롯을 새로고침하려는 경우에 유용합니다.

• 예

  JavaScript

  // Set category exclusion to exclude ads with 'AirlineAd' labels.
  googletag.pubads().setCategoryExclusion("AirlineAd");
  
  // Make ad requests. No ad with 'AirlineAd' label will be returned.
  
  // Clear category exclusions so all ads can be returned.
  googletag.pubads().clearCategoryExclusions();
  
  // Make ad requests. Any ad can be returned.
  

  자바스크립트 (기존)

  // Set category exclusion to exclude ads with 'AirlineAd' labels.
  googletag.pubads().setCategoryExclusion("AirlineAd");
  
  // Make ad requests. No ad with 'AirlineAd' label will be returned.
  
  // Clear category exclusions so all ads can be returned.
  googletag.pubads().clearCategoryExclusions();
  
  // Make ad requests. Any ad can be returned.
  

  TypeScript

  // Set category exclusion to exclude ads with 'AirlineAd' labels.
  googletag.pubads().setCategoryExclusion("AirlineAd");
  
  // Make ad requests. No ad with 'AirlineAd' label will be returned.
  
  // Clear category exclusions so all ads can be returned.
  googletag.pubads().clearCategoryExclusions();
  
  // Make ad requests. Any ad can be returned.
  

  참고 항목

  • 광고를 차단하는 맞춤 라벨

• 반환 값
  PubAdsService	메서드가 호출된 서비스 객체입니다.

---

clearTargeting

• clearTargeting(key?: string): PubAdsService

• 특정 키 또는 모든 키의 맞춤 타겟팅 매개변수를 지웁니다.

• 예

  JavaScript

  googletag.pubads().setTargeting("interests", "sports");
  googletag.pubads().setTargeting("colors", "blue");
  googletag.pubads().setTargeting("fruits", "apple");
  
  googletag.pubads().clearTargeting("interests");
  // Targeting 'colors' and 'fruits' are still present, while 'interests'
  // was cleared.
  
  googletag.pubads().clearTargeting();
  // All targeting has been cleared.
  

  자바스크립트 (기존)

  googletag.pubads().setTargeting("interests", "sports");
  googletag.pubads().setTargeting("colors", "blue");
  googletag.pubads().setTargeting("fruits", "apple");
  
  googletag.pubads().clearTargeting("interests");
  // Targeting 'colors' and 'fruits' are still present, while 'interests'
  // was cleared.
  
  googletag.pubads().clearTargeting();
  // All targeting has been cleared.
  

  TypeScript

  googletag.pubads().setTargeting("interests", "sports");
  googletag.pubads().setTargeting("colors", "blue");
  googletag.pubads().setTargeting("fruits", "apple");
  
  googletag.pubads().clearTargeting("interests");
  // Targeting 'colors' and 'fruits' are still present, while 'interests'
  // was cleared.
  
  googletag.pubads().clearTargeting();
  // All targeting has been cleared.
  

  참고 항목

  • 키-값 타겟팅

• 매개변수
  key?: string	타겟팅 매개변수 키. 키는 선택사항입니다. 지정하지 않으면 모든 타겟팅 매개변수가 지워집니다.

• 반환 값
  PubAdsService	메서드가 호출된 서비스 객체입니다.

---

collapseEmptyDivs

• collapseEmptyDivs(collapseBeforeAdFetch?: boolean): boolean

• 표시할 광고 콘텐츠가 없을 때 슬롯 div가 페이지의 공간을 차지하지 않도록 슬롯 div 축소를 사용 설정합니다. 서비스를 사용 설정하기 전에 이 모드를 설정해야 합니다.

• 참고 항목

  • 빈 광고 슬롯 접기
  • 레이아웃 변경 최소화

• 매개변수
  collapseBeforeAdFetch?: boolean	광고를 가져오기 전에 슬롯을 축소할지 여부입니다. 이 매개변수는 선택사항입니다. 제공하지 않으면 false이 기본값으로 사용됩니다.

• 반환 값
  boolean	div 축소 모드가 사용 설정된 경우 true를 반환하고 서비스가 사용 설정된 후 메서드가 호출되어 축소 모드를 사용 설정할 수 없는 경우 false를 반환합니다.

---

disableInitialLoad

• disableInitialLoad(): void

• 페이지 로드 시 광고 요청을 사용 중지하지만 PubAdsService.refresh 호출을 사용하여 광고를 요청할 수 있습니다. 서비스를 사용 설정하기 전에 설정해야 합니다. 비동기 모드를 사용해야 합니다. 그러지 않으면 refresh를 사용하여 광고를 요청할 수 없습니다.

• 참고 항목

  • 광고 로드 및 새로고침 관리하기
  • SRA 일괄 처리 제어

---

display

• display(adUnitPath: string, size: GeneralSize, div?: string | Element, clickUrl?: string): void

• 지정된 광고 단위 경로와 크기를 가진 광고 슬롯을 생성하고 표시합니다. 이 메서드는 단일 요청 모드에서 작동하지 않습니다.
  
  참고: 이 메서드가 호출되면 광고 요청을 전송하고 응답을 렌더링할 때 일관성을 보장하기 위해 슬롯 및 페이지 상태의 스냅샷이 생성됩니다. 이 메서드가 호출된 후 슬롯 또는 페이지 상태에 적용된 변경사항 (타겟팅, 개인 정보 보호 설정, SafeFrame 강제 등 포함)은 후속 display() 또는 refresh() 요청에만 적용됩니다.

• 예

  JavaScript

  googletag.pubads().display("/1234567/sports", [728, 90], "div-1");
  

  자바스크립트 (기존)

  googletag.pubads().display("/1234567/sports", [728, 90], "div-1");
  

  TypeScript

  googletag.pubads().display("/1234567/sports", [728, 90], "div-1");
  

  참고 항목

  • 테스트 광고 게재하기
  • 광고 로드 및 새로고침 관리하기

• 매개변수
  adUnitPath: string	렌더링될 슬롯의 광고 단위 경로입니다.
  size: GeneralSize	슬롯의 너비 및 높이입니다.
  div?: string | Element	슬롯이 포함된 div의 ID 또는 div 요소 자체입니다.
  clickUrl?: string	이 슬롯에 사용할 클릭 URL입니다.

---

enableLazyLoad

• enableLazyLoad(config?: { fetchMarginPercent: number, mobileScaling: number, renderMarginPercent: number }): void

• 구성 개체에서 정의한 대로 GPT에서 지연 로드를 사용 설정합니다. 자세한 예는 지연 로드 샘플을 참고하세요.
  
  참고: SRA에서의 지연 가져오기는 모든 슬롯이 가져오기 마진을 벗어나는 경우에만 작동합니다.

• 예

  JavaScript

  googletag.pubads().enableLazyLoad({
    // Fetch slots within 5 viewports.
    fetchMarginPercent: 500,
    // Render slots within 2 viewports.
    renderMarginPercent: 200,
    // Double the above values on mobile.
    mobileScaling: 2.0,
  });
  

  자바스크립트 (기존)

  googletag.pubads().enableLazyLoad({
    // Fetch slots within 5 viewports.
    fetchMarginPercent: 500,
    // Render slots within 2 viewports.
    renderMarginPercent: 200,
    // Double the above values on mobile.
    mobileScaling: 2.0,
  });
  

  TypeScript

  googletag.pubads().enableLazyLoad({
    // Fetch slots within 5 viewports.
    fetchMarginPercent: 500,
    // Render slots within 2 viewports.
    renderMarginPercent: 200,
    // Double the above values on mobile.
    mobileScaling: 2.0,
  });
  

  참고 항목

  • Google Ads 권장사항: '중요한' 광고 슬롯의 우선순위 지정
  • 지연 로드

• 매개변수

  config?: { fetchMarginPercent: number, mobileScaling: number, renderMarginPercent: number }

  구성 객체를 사용하면 지연 동작을 맞춤설정할 수 있습니다. 생략된 구성은 Google에서 설정한 기본값을 사용하며, 시간이 지남에 따라 조정됩니다. 가져오기 마진과 같은 특정 설정을 사용 중지하려면 값을 -1로 설정하세요. fetchMarginPercent 광고가 표시 영역 크기의 비율로 가져오기 전에 현재 표시 영역으로부터의 최소 거리여야 합니다. 값 0은 '슬롯이 표시 영역에 들어올 때'를 의미하고, 100은 '광고가 표시 영역 1개에서 떨어진 경우'를 의미합니다. renderMarginPercent 광고가 렌더링되기 전에 슬롯이 현재 표시 영역으로부터 채워져야 하는 최소 거리입니다. 이렇게 하면 광고를 미리 가져오고 다른 하위 리소스를 렌더링하고 다운로드하기 위해 대기할 수 있습니다. 이 값은 표시 영역의 백분율인 fetchMarginPercent와 동일하게 작동합니다. mobileScaling 휴대기기의 여백에 적용되는 배율입니다. 따라서 모바일과 데스크톱에서 마진을 다르게 설정할 수 있습니다. 예를 들어 값 2.0은 휴대기기에서 모든 여백에 2를 곱하므로, 슬롯을 가져오고 렌더링하기 전에 슬롯의 최소 거리를 늘립니다.

---

enableSingleRequest

• enableSingleRequest(): boolean

• 여러 광고를 동시에 가져오는 단일 요청 모드를 사용합니다. 서비스를 사용 설정하기 전에 모든 게시자 광고 슬롯을 정의하고 PubAdsService에 추가해야 합니다. 서비스를 사용 설정하기 전에 단일 요청 모드를 설정해야 합니다.

• 참고 항목

  • Google Ads 권장사항: 단일 요청 아키텍처의 올바른 사용
  • SRA 일괄 처리 제어

• 반환 값
  boolean	단일 요청 모드가 사용 설정된 경우 true을 반환하고 서비스가 사용 설정된 후 메서드가 호출되어 단일 요청 모드를 사용 설정할 수 없는 경우 false를 반환합니다.

---

enableVideoAds

• enableVideoAds(): void

• 페이지에 동영상 광고가 표시될 것임을 GPT에 알립니다. 이렇게 하면 디스플레이 및 동영상 광고에 경쟁 제외 제한을 사용할 수 있습니다. 알려진 동영상 콘텐츠인 경우 디스플레이 광고에 콘텐츠 제외를 사용할 수 있도록 PubAdsService.setVideoContent를 호출합니다.

---

get

• get(key: string): null | string

• 지정된 키와 연결된 애드센스 속성의 값을 반환합니다.

• 예

  JavaScript

  googletag.pubads().set("adsense_background_color", "#FFFFFF");
  googletag.pubads().get("adsense_background_color");
  // Returns '#FFFFFF'.
  

  자바스크립트 (기존)

  googletag.pubads().set("adsense_background_color", "#FFFFFF");
  googletag.pubads().get("adsense_background_color");
  // Returns '#FFFFFF'.
  

  TypeScript

  googletag.pubads().set("adsense_background_color", "#FFFFFF");
  googletag.pubads().get("adsense_background_color");
  // Returns '#FFFFFF'.
  

  참고 항목

  • 애드센스 속성

• 매개변수
  key: string	검색할 속성의 이름입니다.

• 반환 값
  null | string	속성 키의 현재 값 또는 키가 없는 경우 null입니다.

---

getAttributeKeys

• getAttributeKeys(): string[]

• 이 서비스에 설정된 속성 키를 반환합니다.

• 예

  JavaScript

  googletag.pubads().set("adsense_background_color", "#FFFFFF");
  googletag.pubads().set("adsense_border_color", "#AABBCC");
  googletag.pubads().getAttributeKeys();
  // Returns ['adsense_background_color', 'adsense_border_color'].
  

  자바스크립트 (기존)

  googletag.pubads().set("adsense_background_color", "#FFFFFF");
  googletag.pubads().set("adsense_border_color", "#AABBCC");
  googletag.pubads().getAttributeKeys();
  // Returns ['adsense_background_color', 'adsense_border_color'].
  

  TypeScript

  googletag.pubads().set("adsense_background_color", "#FFFFFF");
  googletag.pubads().set("adsense_border_color", "#AABBCC");
  googletag.pubads().getAttributeKeys();
  // Returns ['adsense_background_color', 'adsense_border_color'].
  

• 반환 값
  string[]	이 서비스에 설정된 속성 키의 배열입니다. 순서가 정의되지 않았습니다.

---

getTargeting

• getTargeting(key: string): string[]

• 설정된 특정 맞춤 서비스 수준 타겟팅 매개변수를 반환합니다.

• 예

  JavaScript

  googletag.pubads().setTargeting("interests", "sports");
  
  googletag.pubads().getTargeting("interests");
  // Returns ['sports'].
  
  googletag.pubads().getTargeting("age");
  // Returns [] (empty array).
  

  자바스크립트 (기존)

  googletag.pubads().setTargeting("interests", "sports");
  
  googletag.pubads().getTargeting("interests");
  // Returns ['sports'].
  
  googletag.pubads().getTargeting("age");
  // Returns [] (empty array).
  

  TypeScript

  googletag.pubads().setTargeting("interests", "sports");
  
  googletag.pubads().getTargeting("interests");
  // Returns ['sports'].
  
  googletag.pubads().getTargeting("age");
  // Returns [] (empty array).
  

• 매개변수
  key: string	찾을 타겟팅 키입니다.

• 반환 값
  string[]	이 키와 연결된 값 또는 빈 배열(키가 없는 경우)입니다.

---

getTargetingKeys

• getTargetingKeys(): string[]

• 설정된 모든 맞춤 서비스 수준 타겟팅 키의 목록을 반환합니다.

• 예

  JavaScript

  googletag.pubads().setTargeting("interests", "sports");
  googletag.pubads().setTargeting("colors", "blue");
  
  googletag.pubads().getTargetingKeys();
  // Returns ['interests', 'colors'].
  

  자바스크립트 (기존)

  googletag.pubads().setTargeting("interests", "sports");
  googletag.pubads().setTargeting("colors", "blue");
  
  googletag.pubads().getTargetingKeys();
  // Returns ['interests', 'colors'].
  

  TypeScript

  googletag.pubads().setTargeting("interests", "sports");
  googletag.pubads().setTargeting("colors", "blue");
  
  googletag.pubads().getTargetingKeys();
  // Returns ['interests', 'colors'].
  

• 반환 값
  string[]	타겟팅 키의 배열입니다. 순서가 정의되지 않았습니다.

---

isInitialLoadDisabled

• isInitialLoadDisabled(): boolean

• 광고에 대한 초기 요청이 이전 PubAdsService.disableInitialLoad 호출로 인해 중지되었는지 여부를 반환합니다.

• 반환 값
  boolean	이전 PubAdsService.disableInitialLoad 호출이 성공하면 true, 그렇지 않으면 false를 반환합니다.

---

refresh

• refresh(slots?: null | Slot[], options?: { changeCorrelator: boolean }): void

• 페이지의 특정 또는 모든 슬롯에 새 광고를 가져와 게재합니다. 비동기 렌더링 모드에서만 작동합니다.
  
  모든 브라우저에서 제대로 작동하려면 광고 슬롯을 display 호출한 다음 refresh를 호출해야 합니다. display 호출을 생략하면 새로고침이 예기치 않게 동작할 수 있습니다. 원하는 경우 PubAdsService.disableInitialLoad 메서드를 사용하여 display가 광고를 가져오지 못하도록 할 수 있습니다.
  
  슬롯을 새로고침하면 GPT의 오래 지속되는 페이지 조회에서 이전 광고가 삭제되므로 향후 요청이 해당 광고와 관련된 로드블록이나 경쟁 제외의 영향을 받지 않습니다.

• 예

  JavaScript

  const slot1 = googletag.defineSlot("/1234567/sports", [728, 90], "div-1");
  googletag.display("div-1");
  const slot2 = googletag.defineSlot("/1234567/news", [160, 600], "div-2");
  googletag.display("div-2");
  
  // This call to refresh fetches a new ad for slot1 only.
  googletag.pubads().refresh([slot1]);
  
  // This call to refresh fetches a new ad for both slot1 and slot2.
  googletag.pubads().refresh([slot1, slot2]);
  
  // This call to refresh fetches a new ad for each slot.
  googletag.pubads().refresh();
  
  // This call to refresh fetches a new ad for slot1, without changing
  // the correlator.
  googletag.pubads().refresh([slot1], { changeCorrelator: false });
  
  // This call to refresh fetches a new ad for each slot, without
  // changing the correlator.
  googletag.pubads().refresh(null, { changeCorrelator: false });
  

  자바스크립트 (기존)

  var slot1 = googletag.defineSlot("/1234567/sports", [728, 90], "div-1");
  googletag.display("div-1");
  var slot2 = googletag.defineSlot("/1234567/news", [160, 600], "div-2");
  googletag.display("div-2");
  
  // This call to refresh fetches a new ad for slot1 only.
  googletag.pubads().refresh([slot1]);
  
  // This call to refresh fetches a new ad for both slot1 and slot2.
  googletag.pubads().refresh([slot1, slot2]);
  
  // This call to refresh fetches a new ad for each slot.
  googletag.pubads().refresh();
  
  // This call to refresh fetches a new ad for slot1, without changing
  // the correlator.
  googletag.pubads().refresh([slot1], { changeCorrelator: false });
  
  // This call to refresh fetches a new ad for each slot, without
  // changing the correlator.
  googletag.pubads().refresh(null, { changeCorrelator: false });
  

  TypeScript

  const slot1 = googletag.defineSlot("/1234567/sports", [728, 90], "div-1")!;
  googletag.display("div-1");
  const slot2 = googletag.defineSlot("/1234567/news", [160, 600], "div-2")!;
  googletag.display("div-2");
  
  // This call to refresh fetches a new ad for slot1 only.
  googletag.pubads().refresh([slot1]);
  
  // This call to refresh fetches a new ad for both slot1 and slot2.
  googletag.pubads().refresh([slot1, slot2]);
  
  // This call to refresh fetches a new ad for each slot.
  googletag.pubads().refresh();
  
  // This call to refresh fetches a new ad for slot1, without changing
  // the correlator.
  googletag.pubads().refresh([slot1], { changeCorrelator: false });
  
  // This call to refresh fetches a new ad for each slot, without
  // changing the correlator.
  googletag.pubads().refresh(null, { changeCorrelator: false });
  

  참고 항목

  • 광고 로드 및 새로고침 관리하기
  • 광고 슬롯 새로고침

• 매개변수
  slots?: null | Slot[]	새로고침할 슬롯입니다. 배열은 선택사항입니다. 지정하지 않으면 모든 슬롯이 새로고침됩니다.
  options?: { changeCorrelator: boolean }	이 새로고침 호출과 관련된 구성 옵션입니다. changeCorrelator 광고를 가져오기 위해 새 상관자를 생성할지 여부를 지정합니다. Google 광고 서버는 이 correlator 값을 잠시 (현재 30초 동안 사용할 수 있지만 변경될 수 있음) 유지하여 근접하게 수신된 같은 상관자가 있는 요청은 단일 페이지 조회로 간주됩니다. 기본적으로 새로고침할 때마다 새 상관자가 생성됩니다. 참고: 이 옵션은 현재 페이지에 있는 광고를 자동으로 반영하며 만료 시간이 없는 GPT의 오래 지속되는 페이지 조회에는 영향을 미치지 않습니다.

---

set

• set(key: string, value: string): PubAdsService

• 게시자 광고 서비스의 모든 광고 슬롯에 적용되는 애드센스 속성 값을 설정합니다.
  
  동일한 키에 대해 이 함수를 두 번 이상 호출하면 이전에 해당 키에 대해 설정된 값이 재정의됩니다. 모든 값은 display 또는 refresh를 호출하기 전에 설정해야 합니다.

• 예

  JavaScript

  googletag.pubads().set("adsense_background_color", "#FFFFFF");
  

  자바스크립트 (기존)

  googletag.pubads().set("adsense_background_color", "#FFFFFF");
  

  TypeScript

  googletag.pubads().set("adsense_background_color", "#FFFFFF");
  

  참고 항목

  • 애드센스 속성

• 매개변수
  key: string	속성의 이름입니다.
  value: string	속성 값입니다.

• 반환 값
  PubAdsService	메서드가 호출된 서비스 객체입니다.

---

setCategoryExclusion

• setCategoryExclusion(categoryExclusion: string): PubAdsService

• 지정된 라벨 이름에 대해 페이지 수준 광고 카테고리 제외를 설정합니다.

• 예

  JavaScript

  // Label = AirlineAd.
  googletag.pubads().setCategoryExclusion("AirlineAd");
  

  자바스크립트 (기존)

  // Label = AirlineAd.
  googletag.pubads().setCategoryExclusion("AirlineAd");
  

  TypeScript

  // Label = AirlineAd.
  googletag.pubads().setCategoryExclusion("AirlineAd");
  

  참고 항목

  • 광고를 차단하는 맞춤 라벨

• 매개변수
  categoryExclusion: string	추가할 광고 카테고리 제외 라벨입니다.

• 반환 값
  PubAdsService	메서드가 호출된 서비스 객체입니다.

---

setCentering

• setCentering(centerAds: boolean): void

• 광고의 가로 가운데 맞춤을 사용 설정하거나 사용 중지합니다. 가운데 맞춤은 기본적으로 사용 중지되어 있습니다. 기존 gpt_mobile.js에서는 기본적으로 가운데 맞춤이 사용 설정되어 있습니다.
  
  이 메서드를 호출한 후에 요청한 광고만 중앙에 배치되므로 display 또는 refresh를 호출하기 전에 이 메서드를 호출해야 합니다.

• 예

  JavaScript

  // Make ads centered.
  googletag.pubads().setCentering(true);
  

  자바스크립트 (기존)

  // Make ads centered.
  googletag.pubads().setCentering(true);
  

  TypeScript

  // Make ads centered.
  googletag.pubads().setCentering(true);
  

• 매개변수
  centerAds: boolean	광고를 중앙에 배치하려면 true, 광고를 왼쪽 정렬하려면 false하세요.

---

setForceSafeFrame

• setForceSafeFrame(forceSafeFrame: boolean): PubAdsService

• SafeFrame 컨테이너를 사용하여 페이지의 모든 광고를 강제로 렌더링해야 하는지 여부를 구성합니다.
  
  이 API를 사용하는 동안 다음 사항에 유의하세요.

  • 이 설정은 각 슬롯에 대한 후속 광고 요청에만 적용됩니다.
  • 슬롯 수준 설정이 지정된 경우 항상 페이지 수준 설정보다 우선 적용됩니다.
  • true로 설정하면 (슬롯 수준 또는 페이지 수준에서) 광고가 Google Ad Manager UI에서 선택한 사항과 관계없이 항상 SafeFrame 컨테이너를 사용하여 렌더링됩니다.
  • 하지만 false로 설정하거나 지정하지 않은 상태로 두면 광고 소재 유형 및 Google Ad Manager UI에서 선택한 사항에 따라 광고가 SafeFrame 컨테이너를 사용하여 렌더링됩니다.
  • 이 API는 iFrame을 벗어나려고 하거나 게시자 페이지에서 직접 렌더링되어야 하는 광고 소재의 동작에 영향을 미칠 수 있으므로 주의해서 사용해야 합니다.

• 예

  JavaScript

  googletag.pubads().setForceSafeFrame(true);
  
  // The following slot will be opted-out of the page-level force
  // SafeFrame instruction.
  googletag
    .defineSlot("/1234567/sports", [160, 600], "div-1")
    .setForceSafeFrame(false)
    .addService(googletag.pubads());
  
  // The following slot will have SafeFrame forced.
  googletag.defineSlot("/1234567/news", [160, 600], "div-2").addService(googletag.pubads());
  
  googletag.display("div-1");
  googletag.display("div-2");
  

  자바스크립트 (기존)

  googletag.pubads().setForceSafeFrame(true);
  
  // The following slot will be opted-out of the page-level force
  // SafeFrame instruction.
  googletag
    .defineSlot("/1234567/sports", [160, 600], "div-1")
    .setForceSafeFrame(false)
    .addService(googletag.pubads());
  
  // The following slot will have SafeFrame forced.
  googletag.defineSlot("/1234567/news", [160, 600], "div-2").addService(googletag.pubads());
  
  googletag.display("div-1");
  googletag.display("div-2");
  

  TypeScript

  googletag.pubads().setForceSafeFrame(true);
  
  // The following slot will be opted-out of the page-level force
  // SafeFrame instruction.
  googletag
    .defineSlot("/1234567/sports", [160, 600], "div-1")!
    .setForceSafeFrame(false)
    .addService(googletag.pubads());
  
  // The following slot will have SafeFrame forced.
  googletag.defineSlot("/1234567/news", [160, 600], "div-2")!.addService(googletag.pubads());
  
  googletag.display("div-1");
  googletag.display("div-2");
  

  참고 항목

  • SafeFrame을 사용하여 광고 소재 렌더링하기

• 매개변수
  forceSafeFrame: boolean	true: 페이지의 모든 광고를 SafeFrame에서 렌더링하고 false: 이전 설정을 false로 변경합니다. 앞에서 지정하지 않은 경우 이를 false로 설정하면 아무것도 변경되지 않습니다.

• 반환 값
  PubAdsService	함수가 호출된 서비스 객체입니다.

---

setLocation

• setLocation(address: string): PubAdsService

• 광고 항목을 특정 위치로 지역 타겟팅할 수 있도록 웹사이트의 위치 정보를 전달합니다.

• 예

  JavaScript

  // Postal code:
  googletag.pubads().setLocation("10001,US");
  

  자바스크립트 (기존)

  // Postal code:
  googletag.pubads().setLocation("10001,US");
  

  TypeScript

  // Postal code:
  googletag.pubads().setLocation("10001,US");
  

• 매개변수
  address: string	자유 형식 주소입니다.

• 반환 값
  PubAdsService	메서드가 호출된 서비스 객체입니다.

---

setPrivacySettings

• setPrivacySettings(privacySettings: PrivacySettingsConfig): PubAdsService

• config 객체를 사용하여 단일 API에서 모든 개인 정보 보호 설정을 구성할 수 있습니다.

• 예

  JavaScript

  googletag.pubads().setPrivacySettings({
    restrictDataProcessing: true,
  });
  
  // Set multiple privacy settings at the same time.
  googletag.pubads().setPrivacySettings({
    childDirectedTreatment: true,
    underAgeOfConsent: true,
  });
  
  // Clear the configuration for childDirectedTreatment.
  googletag.pubads().setPrivacySettings({
    childDirectedTreatment: null,
  });
  

  자바스크립트 (기존)

  googletag.pubads().setPrivacySettings({
    restrictDataProcessing: true,
  });
  
  // Set multiple privacy settings at the same time.
  googletag.pubads().setPrivacySettings({
    childDirectedTreatment: true,
    underAgeOfConsent: true,
  });
  
  // Clear the configuration for childDirectedTreatment.
  googletag.pubads().setPrivacySettings({
    childDirectedTreatment: null,
  });
  

  TypeScript

  googletag.pubads().setPrivacySettings({
    restrictDataProcessing: true,
  });
  
  // Set multiple privacy settings at the same time.
  googletag.pubads().setPrivacySettings({
    childDirectedTreatment: true,
    underAgeOfConsent: true,
  });
  
  // Clear the configuration for childDirectedTreatment.
  googletag.pubads().setPrivacySettings({
    childDirectedTreatment: null,
  });
  

  참고 항목

  • 개인 정보 보호 설정 구성하기
  • 제한적인 광고 표시

• 매개변수
  privacySettings: PrivacySettingsConfig	개인 정보 보호 설정 구성을 포함하는 객체입니다.

• 반환 값
  PubAdsService	함수가 호출된 서비스 객체입니다.

---

setPublisherProvidedId

• setPublisherProvidedId(ppid: string): PubAdsService

• 게시자 제공 ID의 값을 설정합니다.

• 예

  JavaScript

  googletag.pubads().setPublisherProvidedId("12JD92JD8078S8J29SDOAKC0EF230337");
  

  자바스크립트 (기존)

  googletag.pubads().setPublisherProvidedId("12JD92JD8078S8J29SDOAKC0EF230337");
  

  TypeScript

  googletag.pubads().setPublisherProvidedId("12JD92JD8078S8J29SDOAKC0EF230337");
  

  참고 항목

  • 게시자 제공 식별자에 대하여

• 매개변수
  ppid: string	게시자가 제공한 영숫자 ID입니다. 32~150자(영문 기준)여야 합니다.

• 반환 값
  PubAdsService	메서드가 호출된 서비스 객체입니다.

---

setSafeFrameConfig

• setSafeFrameConfig(config: SafeFrameConfig): PubAdsService

• SafeFrame 구성에 대한 페이지 수준 환경설정을 설정합니다. 구성 객체에서 인식할 수 없는 키는 무시됩니다. 인식된 키에 잘못된 값이 전달되면 전체 구성이 무시됩니다.
  
  지정된 경우 이러한 페이지 수준 환경설정이 슬롯 수준 환경설정에 의해 재정의됩니다.

• 예

  JavaScript

  googletag.pubads().setForceSafeFrame(true);
  
  const pageConfig = {
    allowOverlayExpansion: true,
    allowPushExpansion: true,
    sandbox: true,
  };
  
  const slotConfig = { allowOverlayExpansion: false };
  
  googletag.pubads().setSafeFrameConfig(pageConfig);
  
  // The following slot will not allow for expansion by overlay.
  googletag
    .defineSlot("/1234567/sports", [160, 600], "div-1")
    .setSafeFrameConfig(slotConfig)
    .addService(googletag.pubads());
  
  // The following slot will inherit the page level settings, and hence
  // would allow for expansion by overlay.
  googletag.defineSlot("/1234567/news", [160, 600], "div-2").addService(googletag.pubads());
  
  googletag.display("div-1");
  googletag.display("div-2");
  

  자바스크립트 (기존)

  googletag.pubads().setForceSafeFrame(true);
  
  var pageConfig = {
    allowOverlayExpansion: true,
    allowPushExpansion: true,
    sandbox: true,
  };
  
  var slotConfig = { allowOverlayExpansion: false };
  
  googletag.pubads().setSafeFrameConfig(pageConfig);
  
  // The following slot will not allow for expansion by overlay.
  googletag
    .defineSlot("/1234567/sports", [160, 600], "div-1")
    .setSafeFrameConfig(slotConfig)
    .addService(googletag.pubads());
  
  // The following slot will inherit the page level settings, and hence
  // would allow for expansion by overlay.
  googletag.defineSlot("/1234567/news", [160, 600], "div-2").addService(googletag.pubads());
  
  googletag.display("div-1");
  googletag.display("div-2");
  

  TypeScript

  googletag.pubads().setForceSafeFrame(true);
  
  const pageConfig = {
    allowOverlayExpansion: true,
    allowPushExpansion: true,
    sandbox: true,
  };
  
  const slotConfig = { allowOverlayExpansion: false };
  
  googletag.pubads().setSafeFrameConfig(pageConfig);
  
  // The following slot will not allow for expansion by overlay.
  googletag
    .defineSlot("/1234567/sports", [160, 600], "div-1")!
    .setSafeFrameConfig(slotConfig)
    .addService(googletag.pubads());
  
  // The following slot will inherit the page level settings, and hence
  // would allow for expansion by overlay.
  googletag.defineSlot("/1234567/news", [160, 600], "div-2")!.addService(googletag.pubads());
  
  googletag.display("div-1");
  googletag.display("div-2");
  

  참고 항목

  • SafeFrame을 사용하여 광고 소재 렌더링하기

• 매개변수
  config: SafeFrameConfig	구성 객체입니다.

• 반환 값
  PubAdsService	메서드가 호출된 서비스 객체입니다.

---

setTargeting

• setTargeting(key: string, value: string | string[]): PubAdsService

• 모든 게시자 광고 서비스 광고 슬롯에 적용되는 특정 키에 대해 맞춤 타겟팅 매개변수를 설정합니다. 동일한 키에 대해 이 함수를 여러 번 호출하면 이전 값을 덮어씁니다. 이러한 키는 Google Ad Manager 계정에서 정의됩니다.

• 예

  JavaScript

  // Example with a single value for a key.
  googletag.pubads().setTargeting("interests", "sports");
  
  // Example with multiple values for a key inside in an array.
  googletag.pubads().setTargeting("interests", ["sports", "music"]);
  

  자바스크립트 (기존)

  // Example with a single value for a key.
  googletag.pubads().setTargeting("interests", "sports");
  
  // Example with multiple values for a key inside in an array.
  googletag.pubads().setTargeting("interests", ["sports", "music"]);
  

  TypeScript

  // Example with a single value for a key.
  googletag.pubads().setTargeting("interests", "sports");
  
  // Example with multiple values for a key inside in an array.
  googletag.pubads().setTargeting("interests", ["sports", "music"]);
  

  참고 항목

  • 키-값 타겟팅

• 매개변수
  key: string	타겟팅 매개변수 키.
  value: string | string[]	타겟팅 매개변수 값 또는 값의 배열입니다.

• 반환 값
  PubAdsService	메서드가 호출된 서비스 객체입니다.

---

setVideoContent

• setVideoContent(videoContentId: string, videoCmsId: string): void

• 타겟팅 및 콘텐츠 제외를 위해 동영상 콘텐츠 정보가 광고 요청과 함께 전송되도록 설정합니다. 이 메서드가 호출되면 동영상 광고가 자동으로 사용 설정됩니다. videoContentId 및 videoCmsId의 경우 Google Ad Manager 콘텐츠 처리 서비스에 제공된 값을 사용합니다.

• 참고 항목

  • VAST 광고 태그 URL 매개변수

• 매개변수
  videoContentId: string	동영상 콘텐츠 ID입니다.
  videoCmsId: string	동영상 CMS ID입니다.

---

updateCorrelator

• updateCorrelator(): PubAdsService

• 광고 요청과 함께 전송되는 상관자를 변경하여 효과적으로 새 페이지 조회를 시작합니다. 상관자는 한 페이지 조회에서 발생하는 모든 광고 요청에 대해 동일하며 페이지 조회 전체에서 고유합니다. 비동기 모드에만 적용됩니다.
  
  참고: 이는 페이지에 실제로 광고가 자동으로 반영되며 만료 시간이 없는 GPT의 오래 지속되는 페이지 조회에는 영향을 미치지 않습니다.

• 예

  JavaScript

  // Assume that the correlator is currently 12345. All ad requests made
  // by this page will currently use that value.
  
  // Replace the current correlator with a new correlator.
  googletag.pubads().updateCorrelator();
  
  // The correlator will now be a new randomly selected value, different
  // from 12345. All subsequent ad requests made by this page will use
  // the new value.
  

  자바스크립트 (기존)

  // Assume that the correlator is currently 12345. All ad requests made
  // by this page will currently use that value.
  
  // Replace the current correlator with a new correlator.
  googletag.pubads().updateCorrelator();
  
  // The correlator will now be a new randomly selected value, different
  // from 12345. All subsequent ad requests made by this page will use
  // the new value.
  

  TypeScript

  // Assume that the correlator is currently 12345. All ad requests made
  // by this page will currently use that value.
  
  // Replace the current correlator with a new correlator.
  googletag.pubads().updateCorrelator();
  
  // The correlator will now be a new randomly selected value, different
  // from 12345. All subsequent ad requests made by this page will use
  // the new value.
  

• 반환 값
  PubAdsService	함수가 호출된 서비스 객체입니다.

---

googletagResponseInformation

단일 광고 응답을 나타내는 객체입니다.

속성 요약
advertiserId	광고주의 ID입니다.
campaignId	캠페인의 ID입니다.
creativeId	광고 소재의 ID입니다.
creativeTemplateId	광고의 템플릿 ID입니다.
lineItemId	광고 항목의 ID입니다.

참고 항목

• Slot.getResponseInformation

---

advertiserId

• advertiserId: null | number

• 광고주의 ID입니다.

---

campaignId

• campaignId: null | number

• 캠페인의 ID입니다.

---

creativeId

• creativeId: null | number

• 광고 소재의 ID입니다.

---

creativeTemplateId

• creativeTemplateId: null | number

• 광고의 템플릿 ID입니다.

---

lineItemId

• lineItemId: null | number

• 광고 항목의 ID입니다.

---

googletagRewardedPayload

보상형 광고와 연결된 리워드를 나타내는 객체입니다.

속성 요약
amount	리워드에 포함된 상품의 개수입니다.
type	리워드에 포함된 상품의 유형입니다 (예: '코인').

참고 항목

• 보상형 광고 표시

---

amount

• amount: number

• 리워드에 포함된 상품의 개수입니다.

---

type

• type: string

• 리워드에 포함된 상품의 유형입니다 (예: '코인').

---

googletagSafeFrameConfig

SafeFrame 컨테이너의 구성 객체입니다.

속성 요약
allowOverlayExpansion	SafeFrame에서 페이지 콘텐츠를 오버레이하여 광고 콘텐츠를 펼칠 수 있도록 허용해야 하는지 여부입니다.
allowPushExpansion	SafeFrame에서 페이지 콘텐츠를 푸시하여 광고 콘텐츠가 확장되도록 허용해야 하는지 여부입니다.
sandbox	사용자 상호작용 없는 최상위 탐색을 방지하기 위해 SafeFrame에서 HTML5 샌드박스 속성을 사용해야 하는지 여부입니다.
useUniqueDomain	지원 중단되었습니다. SafeFrame이 예약 광고 소재에 임의의 하위 도메인을 사용해야 하는지 여부입니다.

참고 항목

• PubAdsService.setSafeFrameConfig

---

allowOverlayExpansion

• allowOverlayExpansion: boolean

• SafeFrame에서 페이지 콘텐츠를 오버레이하여 광고 콘텐츠를 펼칠 수 있도록 허용해야 하는지 여부입니다.

---

allowPushExpansion

• allowPushExpansion: boolean

• SafeFrame에서 페이지 콘텐츠를 푸시하여 광고 콘텐츠가 확장되도록 허용해야 하는지 여부입니다.

---

sandbox

• sandbox: boolean

• 사용자 상호작용 없는 최상위 탐색을 방지하기 위해 SafeFrame에서 HTML5 샌드박스 속성을 사용해야 하는지 여부입니다. 유일하게 유효한 값은 true입니다 (false로 강제 설정할 수 없음). 샌드박스 속성은 플러그인 (예: Flash)을 사용 중지합니다.

---

useUniqueDomain

• useUniqueDomain: null | boolean

• SafeFrame이 예약 광고 소재에 임의의 하위 도메인을 사용해야 하는지 여부입니다. 저장된 값을 지우려면 null를 전달합니다.
  
  참고: 이 기능은 기본적으로 사용 설정되어 있습니다.

지원 중단됨: 이 기능은 더 이상 사용 중지할 수 없습니다. useUniqueDomain을(를) 설정해도 효과가 없습니다.

• 참고 항목

  • SafeFrame을 사용하여 광고 소재 렌더링하기

---

googletagService

모든 서비스에 공통된 메서드가 포함된 기본 서비스 클래스입니다.

메서드 요약
addEventListener	페이지에서 특정 GPT 이벤트가 발생할 때 자바스크립트 함수를 설정하고 호출할 수 있도록 하는 리스너를 등록합니다.
getSlots	이 서비스와 연결된 슬롯 목록을 가져옵니다.
removeEventListener	이전에 등록된 리스너를 제거합니다.

---

addEventListener

• addEventListener<K extends keyof EventTypeMap>(eventType: K, listener: (arg: EventTypeMap[K]) => void): Service

• 페이지에서 특정 GPT 이벤트가 발생할 때 자바스크립트 함수를 설정하고 호출할 수 있도록 하는 리스너를 등록합니다. 지원되는 이벤트는 다음과 같습니다.

  • events.ImpressionViewableEvent
  • events.RewardedSlotClosedEvent
  • events.RewardedSlotGrantedEvent
  • events.RewardedSlotReadyEvent
  • events.SlotOnloadEvent
  • events.SlotRenderEndedEvent
  • events.SlotRequestedEvent
  • events.SlotResponseReceived
  • events.SlotVisibilityChangedEvent

  호출 시 적절한 이벤트 유형의 객체가 리스너에 전달됩니다.

• 예

  JavaScript

  // 1. Adding an event listener for the PubAdsService.
  googletag.pubads().addEventListener("slotOnload", (event) => {
    console.log("Slot has been loaded:");
    console.log(event);
  });
  
  // 2. Adding an event listener with slot specific logic.
  // Listeners operate at service level, which means that you cannot add
  // a listener for an event for a specific slot only. You can, however,
  // programmatically filter a listener to respond only to a certain ad
  // slot, using this pattern:
  const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
  googletag.pubads().addEventListener("slotOnload", (event) => {
    if (event.slot === targetSlot) {
      // Slot specific logic.
    }
  });
  

  자바스크립트 (기존)

  // 1. Adding an event listener for the PubAdsService.
  googletag.pubads().addEventListener("slotOnload", function (event) {
    console.log("Slot has been loaded:");
    console.log(event);
  });
  
  // 2. Adding an event listener with slot specific logic.
  // Listeners operate at service level, which means that you cannot add
  // a listener for an event for a specific slot only. You can, however,
  // programmatically filter a listener to respond only to a certain ad
  // slot, using this pattern:
  var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
  googletag.pubads().addEventListener("slotOnload", function (event) {
    if (event.slot === targetSlot) {
      // Slot specific logic.
    }
  });
  

  TypeScript

  // 1. Adding an event listener for the PubAdsService.
  googletag.pubads().addEventListener("slotOnload", (event) => {
    console.log("Slot has been loaded:");
    console.log(event);
  });
  
  // 2. Adding an event listener with slot specific logic.
  // Listeners operate at service level, which means that you cannot add
  // a listener for an event for a specific slot only. You can, however,
  // programmatically filter a listener to respond only to a certain ad
  // slot, using this pattern:
  const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
  googletag.pubads().addEventListener("slotOnload", (event) => {
    if (event.slot === targetSlot) {
      // Slot specific logic.
    }
  });
  

  참고 항목

  • 광고 이벤트 리스너

• 매개변수
  eventType: K	GPT에서 생성한 이벤트 유형을 나타내는 문자열입니다. 이벤트 유형은 대소문자를 구분합니다.
  listener: (arg: EventTypeMap[K]) => void	단일 이벤트 객체 인수를 사용하는 함수입니다.

• 반환 값
  Service	메서드가 호출된 서비스 객체입니다.

---

getSlots

• getSlots(): Slot[]

• 이 서비스와 연결된 슬롯 목록을 가져옵니다.

• 반환 값
  Slot[]	서비스에 추가된 순서의 슬롯입니다.

---

removeEventListener

• removeEventListener<K extends keyof EventTypeMap>(eventType: K, listener: (event: EventTypeMap[K]) => void): void

• 이전에 등록된 리스너를 제거합니다.

• 예

  JavaScript

  googletag.cmd.push(() => {
    // Define a new ad slot.
    googletag.defineSlot("/6355419/Travel", [728, 90], "div-for-slot").addService(googletag.pubads());
  
    // Define a new function that removes itself via removeEventListener
    // after the impressionViewable event fires.
    const onViewableListener = (event) => {
      googletag.pubads().removeEventListener("impressionViewable", onViewableListener);
      setTimeout(() => {
        googletag.pubads().refresh([event.slot]);
      }, 30000);
    };
  
    // Add onViewableListener as a listener for impressionViewable events.
    googletag.pubads().addEventListener("impressionViewable", onViewableListener);
    googletag.enableServices();
  });
  

  자바스크립트 (기존)

  googletag.cmd.push(function () {
    // Define a new ad slot.
    googletag.defineSlot("/6355419/Travel", [728, 90], "div-for-slot").addService(googletag.pubads());
  
    // Define a new function that removes itself via removeEventListener
    // after the impressionViewable event fires.
    var onViewableListener = function (event) {
      googletag.pubads().removeEventListener("impressionViewable", onViewableListener);
      setTimeout(function () {
        googletag.pubads().refresh([event.slot]);
      }, 30000);
    };
  
    // Add onViewableListener as a listener for impressionViewable events.
    googletag.pubads().addEventListener("impressionViewable", onViewableListener);
    googletag.enableServices();
  });
  

  TypeScript

  googletag.cmd.push(() => {
    // Define a new ad slot.
    googletag
      .defineSlot("/6355419/Travel", [728, 90], "div-for-slot")!
      .addService(googletag.pubads());
  
    // Define a new function that removes itself via removeEventListener
    // after the impressionViewable event fires.
    const onViewableListener = (event: googletag.events.ImpressionViewableEvent) => {
      googletag.pubads().removeEventListener("impressionViewable", onViewableListener);
      setTimeout(() => {
        googletag.pubads().refresh([event.slot]);
      }, 30000);
    };
  
    // Add onViewableListener as a listener for impressionViewable events.
    googletag.pubads().addEventListener("impressionViewable", onViewableListener);
    googletag.enableServices();
  });
  

• 매개변수
  eventType: K	GPT에서 생성한 이벤트 유형을 나타내는 문자열입니다. 이벤트 유형은 대소문자를 구분합니다.
  listener: (event: EventTypeMap[K]) => void	단일 이벤트 객체 인수를 사용하는 함수입니다.

---

googletagSizeMappingBuilder

크기 매핑 사양 객체의 빌더입니다. 크기 사양을 쉽게 구성할 수 있도록 이 빌더가 제공됩니다.

메서드 요약
addSize	표시 영역을 나타내는 단일 크기 배열에서 슬롯을 나타내는 단일 또는 여러 크기 배열로의 매핑을 추가합니다.
build	이 빌더에 추가된 매핑에서 크기 맵 사양을 작성합니다.

참고 항목

• 광고 크기: 반응형 광고

---

addSize

• addSize(viewportSize: SingleSizeArray, slotSize: GeneralSize): SizeMappingBuilder

• 표시 영역을 나타내는 단일 크기 배열에서 슬롯을 나타내는 단일 또는 여러 크기 배열로의 매핑을 추가합니다.

• 예

  JavaScript

  // Mapping 1
  googletag
    .sizeMapping()
    .addSize([1024, 768], [970, 250])
    .addSize([980, 690], [728, 90])
    .addSize([640, 480], "fluid")
    .addSize([0, 0], [88, 31]) // All viewports < 640x480
    .build();
  
  // Mapping 2
  googletag
    .sizeMapping()
    .addSize([1024, 768], [970, 250])
    .addSize([980, 690], [])
    .addSize([640, 480], [120, 60])
    .addSize([0, 0], [])
    .build();
  
  // Mapping 2 will not show any ads for the following viewport sizes:
  // [1024, 768] > size >= [980, 690] and
  // [640, 480] > size >= [0, 0]
  

  자바스크립트 (기존)

  // Mapping 1
  googletag
    .sizeMapping()
    .addSize([1024, 768], [970, 250])
    .addSize([980, 690], [728, 90])
    .addSize([640, 480], "fluid")
    .addSize([0, 0], [88, 31]) // All viewports < 640x480
    .build();
  
  // Mapping 2
  googletag
    .sizeMapping()
    .addSize([1024, 768], [970, 250])
    .addSize([980, 690], [])
    .addSize([640, 480], [120, 60])
    .addSize([0, 0], [])
    .build();
  
  // Mapping 2 will not show any ads for the following viewport sizes:
  // [1024, 768] > size >= [980, 690] and
  // [640, 480] > size >= [0, 0]
  

  TypeScript

  // Mapping 1
  googletag
    .sizeMapping()
    .addSize([1024, 768], [970, 250])
    .addSize([980, 690], [728, 90])
    .addSize([640, 480], "fluid")
    .addSize([0, 0], [88, 31]) // All viewports < 640x480
    .build();
  
  // Mapping 2
  googletag
    .sizeMapping()
    .addSize([1024, 768], [970, 250])
    .addSize([980, 690], [])
    .addSize([640, 480], [120, 60])
    .addSize([0, 0], [])
    .build();
  
  // Mapping 2 will not show any ads for the following viewport sizes:
  // [1024, 768] > size >= [980, 690] and
  // [640, 480] > size >= [0, 0]
  

• 매개변수
  viewportSize: SingleSizeArray	이 매핑 항목의 표시 영역 크기입니다.
  slotSize: GeneralSize	이 매핑 항목의 슬롯 크기입니다.

• 반환 값
  SizeMappingBuilder	이 빌더에 대한 참조입니다.

---

build

• build(): null | SizeMappingArray

• 이 빌더에 추가된 매핑에서 크기 맵 사양을 작성합니다.
  
  잘못된 매핑이 제공된 경우 이 메서드는 null를 반환합니다. 그렇지 않으면 Slot.defineSizeMapping에 전달할 올바른 형식으로 사양을 반환합니다.
  
  참고: 이 메서드를 호출한 후 빌더의 동작은 정의되지 않습니다.

• 반환 값
  null | SizeMappingArray	이 빌더에 의해 빌드된 결과입니다. 잘못된 크기 매핑이 제공된 경우 null일 수 있습니다.

---

googletagSlot

슬롯은 페이지의 단일 광고 슬롯을 나타내는 객체입니다.

메서드 요약
addService	이 슬롯에 Service를 추가합니다.
clearCategoryExclusions	이 슬롯에 대한 모든 슬롯 수준 광고 카테고리 제외 라벨을 지웁니다.
clearTargeting	이 슬롯에 대한 특정 또는 모든 맞춤 슬롯 수준 타겟팅 매개변수를 삭제합니다.
defineSizeMapping	이 슬롯의 최소 표시 영역 크기에서 슬롯 크기로 매핑의 배열을 설정합니다.
get	이 슬롯의 지정된 키와 연결된 애드센스 속성의 값을 반환합니다.
getAdUnitPath	네트워크 코드 및 광고 단위 경로와 함께 광고 단위의 전체 경로를 반환합니다.
getAttributeKeys	이 슬롯에 설정된 속성 키 목록을 반환합니다.
getCategoryExclusions	이 슬롯의 광고 카테고리 제외 라벨을 반환합니다.
getResponseInformation	광고 응답 정보를 반환합니다.
getSlotElementId	슬롯이 정의되었을 때 제공된 슬롯 div의 ID를 반환합니다.
getTargeting	이 슬롯에 설정된 특정 맞춤 타겟팅 매개변수를 반환합니다.
getTargetingKeys	이 슬롯에 설정된 모든 맞춤 타겟팅 키의 목록을 반환합니다.
set	이 광고 슬롯의 애드센스 속성 값을 설정합니다.
setCategoryExclusion	이 슬롯에 슬롯 수준 광고 카테고리 제외 라벨을 설정합니다.
setClickUrl	사용자가 광고를 클릭한 후 리디렉션되는 클릭 URL을 설정합니다.
setCollapseEmptyDiv	슬롯에 광고가 없을 때 슬롯 div을 숨겨야 하는지 여부를 설정합니다.
setConfig	이 슬롯의 일반 구성 옵션을 설정합니다.
setForceSafeFrame	이 슬롯의 광고를 SafeFrame 컨테이너를 사용하여 강제로 렌더링해야 하는지 여부를 구성합니다.
setSafeFrameConfig	SafeFrame 구성에 대한 슬롯 수준 환경설정을 설정합니다.
setTargeting	이 슬롯에 맞춤 타겟팅 매개변수를 설정합니다.
updateTargetingFromMap	JSON 객체의 키:값 맵에서 이 슬롯의 맞춤 타겟팅 매개변수를 설정합니다.

---

addService

• addService(service: Service): Slot

• 이 슬롯에 Service를 추가합니다.

• 예

  JavaScript

  googletag.defineSlot("/1234567/sports", [160, 600], "div").addService(googletag.pubads());
  

  자바스크립트 (기존)

  googletag.defineSlot("/1234567/sports", [160, 600], "div").addService(googletag.pubads());
  

  TypeScript

  googletag.defineSlot("/1234567/sports", [160, 600], "div")!.addService(googletag.pubads());
  

  참고 항목

  • Google 게시자 태그 시작하기
  • 테스트 광고 게재하기

• 매개변수
  service: Service	추가할 서비스입니다.

• 반환 값
  Slot	메서드가 호출된 슬롯 객체입니다.

---

clearCategoryExclusions

• clearCategoryExclusions(): Slot

• 이 슬롯에 대한 모든 슬롯 수준 광고 카테고리 제외 라벨을 지웁니다.

• 예

  JavaScript

  // Set category exclusion to exclude ads with 'AirlineAd' labels.
  const slot = googletag
    .defineSlot("/1234567/sports", [160, 600], "div")
    .setCategoryExclusion("AirlineAd")
    .addService(googletag.pubads());
  
  // Make an ad request. No ad with 'AirlineAd' label will be returned
  // for the slot.
  
  // Clear category exclusions so all ads can be returned.
  slot.clearCategoryExclusions();
  
  // Make an ad request. Any ad can be returned for the slot.
  

  자바스크립트 (기존)

  // Set category exclusion to exclude ads with 'AirlineAd' labels.
  var slot = googletag
    .defineSlot("/1234567/sports", [160, 600], "div")
    .setCategoryExclusion("AirlineAd")
    .addService(googletag.pubads());
  
  // Make an ad request. No ad with 'AirlineAd' label will be returned
  // for the slot.
  
  // Clear category exclusions so all ads can be returned.
  slot.clearCategoryExclusions();
  
  // Make an ad request. Any ad can be returned for the slot.
  

  TypeScript

  // Set category exclusion to exclude ads with 'AirlineAd' labels.
  const slot = googletag
    .defineSlot("/1234567/sports", [160, 600], "div")!
    .setCategoryExclusion("AirlineAd")
    .addService(googletag.pubads());
  
  // Make an ad request. No ad with 'AirlineAd' label will be returned
  // for the slot.
  
  // Clear category exclusions so all ads can be returned.
  slot.clearCategoryExclusions();
  
  // Make an ad request. Any ad can be returned for the slot.
  

• 반환 값
  Slot	메서드가 호출된 슬롯 객체입니다.

---

clearTargeting

• clearTargeting(key?: string): Slot

• 이 슬롯에 대한 특정 또는 모든 맞춤 슬롯 수준 타겟팅 매개변수를 삭제합니다.

• 예

  JavaScript

  const slot = googletag
    .defineSlot("/1234567/sports", [160, 600], "div")
    .setTargeting("allow_expandable", "true")
    .setTargeting("interests", ["sports", "music"])
    .setTargeting("color", "red")
    .addService(googletag.pubads());
  
  slot.clearTargeting("color");
  // Targeting 'allow_expandable' and 'interests' are still present,
  // while 'color' was cleared.
  
  slot.clearTargeting();
  // All targeting has been cleared.
  

  자바스크립트 (기존)

  var slot = googletag
    .defineSlot("/1234567/sports", [160, 600], "div")
    .setTargeting("allow_expandable", "true")
    .setTargeting("interests", ["sports", "music"])
    .setTargeting("color", "red")
    .addService(googletag.pubads());
  
  slot.clearTargeting("color");
  // Targeting 'allow_expandable' and 'interests' are still present,
  // while 'color' was cleared.
  
  slot.clearTargeting();
  // All targeting has been cleared.
  

  TypeScript

  const slot = googletag
    .defineSlot("/1234567/sports", [160, 600], "div")!
    .setTargeting("allow_expandable", "true")
    .setTargeting("interests", ["sports", "music"])
    .setTargeting("color", "red")
    .addService(googletag.pubads());
  
  slot.clearTargeting("color");
  // Targeting 'allow_expandable' and 'interests' are still present,
  // while 'color' was cleared.
  
  slot.clearTargeting();
  // All targeting has been cleared.
  

  참고 항목

  • 키-값 타겟팅

• 매개변수
  key?: string	타겟팅 매개변수 키. 키는 선택사항입니다. 지정하지 않으면 모든 타겟팅 매개변수가 지워집니다.

• 반환 값
  Slot	메서드가 호출된 슬롯 객체입니다.

---

defineSizeMapping

• defineSizeMapping(sizeMapping: SizeMappingArray): Slot

• 이 슬롯의 최소 표시 영역 크기에서 슬롯 크기로 매핑의 배열을 설정합니다.

• 예

  JavaScript

  const slot = googletag
    .defineSlot("/1234567/sports", [160, 600], "div")
    .addService(googletag.pubads());
  
  const mapping = googletag
    .sizeMapping()
    .addSize([100, 100], [88, 31])
    .addSize(
      [320, 400],
      [
        [320, 50],
        [300, 50],
      ]
    )
    .build();
  
  slot.defineSizeMapping(mapping);
  

  자바스크립트 (기존)

  var slot = googletag
    .defineSlot("/1234567/sports", [160, 600], "div")
    .addService(googletag.pubads());
  
  var mapping = googletag
    .sizeMapping()
    .addSize([100, 100], [88, 31])
    .addSize(
      [320, 400],
      [
        [320, 50],
        [300, 50],
      ]
    )
    .build();
  
  slot.defineSizeMapping(mapping);
  

  TypeScript

  const slot = googletag
    .defineSlot("/1234567/sports", [160, 600], "div")!
    .addService(googletag.pubads());
  
  const mapping = googletag
    .sizeMapping()
    .addSize([100, 100], [88, 31])
    .addSize(
      [320, 400],
      [
        [320, 50],
        [300, 50],
      ]
    )
    .build();
  
  slot.defineSizeMapping(mapping!);
  

  참고 항목

  • 광고 크기: 반응형 광고

• 매개변수
  sizeMapping: SizeMappingArray	크기 매핑의 배열입니다. SizeMappingBuilder를 사용하여 만들 수 있습니다. 각 크기 매핑은 두 요소(SingleSizeArray 및 GeneralSize)의 배열입니다.

• 반환 값
  Slot	메서드가 호출된 슬롯 객체입니다.

---

get

• get(key: string): null | string

• 이 슬롯의 지정된 키와 연결된 애드센스 속성의 값을 반환합니다. 이 슬롯에 상속된 서비스 수준 속성을 보려면 PubAdsService.get를 사용하세요.

• 예

  JavaScript

  const slot = googletag
    .defineSlot("/1234567/sports", [160, 600], "div")
    .set("adsense_background_color", "#FFFFFF")
    .addService(googletag.pubads());
  
  slot.get("adsense_background_color");
  // Returns '#FFFFFF'.
  

  자바스크립트 (기존)

  var slot = googletag
    .defineSlot("/1234567/sports", [160, 600], "div")
    .set("adsense_background_color", "#FFFFFF")
    .addService(googletag.pubads());
  
  slot.get("adsense_background_color");
  // Returns '#FFFFFF'.
  

  TypeScript

  const slot = googletag
    .defineSlot("/1234567/sports", [160, 600], "div")!
    .set("adsense_background_color", "#FFFFFF")
    .addService(googletag.pubads());
  
  slot.get("adsense_background_color");
  // Returns '#FFFFFF'.
  

  참고 항목

  • 애드센스 속성

• 매개변수
  key: string	검색할 속성의 이름입니다.

• 반환 값
  null | string	속성 키의 현재 값 또는 키가 없는 경우 null입니다.

---

getAdUnitPath

• getAdUnitPath(): string

• 네트워크 코드 및 광고 단위 경로와 함께 광고 단위의 전체 경로를 반환합니다.

• 예

  JavaScript

  const slot = googletag
    .defineSlot("/1234567/sports", [160, 600], "div")
    .addService(googletag.pubads());
  
  slot.getAdUnitPath();
  // Returns '/1234567/sports'.
  

  자바스크립트 (기존)

  var slot = googletag
    .defineSlot("/1234567/sports", [160, 600], "div")
    .addService(googletag.pubads());
  
  slot.getAdUnitPath();
  // Returns '/1234567/sports'.
  

  TypeScript

  const slot = googletag
    .defineSlot("/1234567/sports", [160, 600], "div")!
    .addService(googletag.pubads());
  
  slot.getAdUnitPath();
  // Returns '/1234567/sports'.
  

• 반환 값
  string	광고 단위 경로입니다.

---

getAttributeKeys

• getAttributeKeys(): string[]

• 이 슬롯에 설정된 속성 키 목록을 반환합니다. 이 슬롯에 상속된 서비스 수준 속성의 키를 보려면 PubAdsService.getAttributeKeys를 사용합니다.

• 예

  JavaScript

  const slot = googletag
    .defineSlot("/1234567/sports", [160, 600], "div")
    .set("adsense_background_color", "#FFFFFF")
    .set("adsense_border_color", "#AABBCC")
    .addService(googletag.pubads());
  
  slot.getAttributeKeys();
  // Returns ['adsense_background_color', 'adsense_border_color'].
  

  자바스크립트 (기존)

  var slot = googletag
    .defineSlot("/1234567/sports", [160, 600], "div")
    .set("adsense_background_color", "#FFFFFF")
    .set("adsense_border_color", "#AABBCC")
    .addService(googletag.pubads());
  
  slot.getAttributeKeys();
  // Returns ['adsense_background_color', 'adsense_border_color'].
  

  TypeScript

  const slot = googletag
    .defineSlot("/1234567/sports", [160, 600], "div")!
    .set("adsense_background_color", "#FFFFFF")
    .set("adsense_border_color", "#AABBCC")
    .addService(googletag.pubads());
  
  slot.getAttributeKeys();
  // Returns ['adsense_background_color', 'adsense_border_color'].
  

• 반환 값
  string[]	속성 키의 배열입니다. 순서가 정의되지 않았습니다.

---

getCategoryExclusions

• getCategoryExclusions(): string[]

• 이 슬롯의 광고 카테고리 제외 라벨을 반환합니다.

• 예

  JavaScript

  const slot = googletag
    .defineSlot("/1234567/sports", [160, 600], "div")
    .setCategoryExclusion("AirlineAd")
    .setCategoryExclusion("TrainAd")
    .addService(googletag.pubads());
  
  slot.getCategoryExclusions();
  // Returns ['AirlineAd', 'TrainAd'].
  

  자바스크립트 (기존)

  var slot = googletag
    .defineSlot("/1234567/sports", [160, 600], "div")
    .setCategoryExclusion("AirlineAd")
    .setCategoryExclusion("TrainAd")
    .addService(googletag.pubads());
  
  slot.getCategoryExclusions();
  // Returns ['AirlineAd', 'TrainAd'].
  

  TypeScript

  const slot = googletag
    .defineSlot("/1234567/sports", [160, 600], "div")!
    .setCategoryExclusion("AirlineAd")
    .setCategoryExclusion("TrainAd")
    .addService(googletag.pubads());
  
  slot.getCategoryExclusions();
  // Returns ['AirlineAd', 'TrainAd'].
  

• 반환 값
  string[]	이 슬롯의 광고 카테고리 제외 라벨 또는 아무것도 설정되지 않은 경우 빈 배열입니다.

---

getResponseInformation

• getResponseInformation(): null | ResponseInformation

• 광고 응답 정보를 반환합니다. 이는 해당 슬롯의 마지막 광고 응답을 기반으로 합니다. 슬롯에 광고가 없을 때 이 메서드를 호출하면 null가 반환됩니다.

• 반환 값
  null | ResponseInformation	최신 광고 응답 정보 또는 슬롯에 광고가 없는 경우 null입니다.

---

getSlotElementId

• getSlotElementId(): string

• 슬롯이 정의되었을 때 제공된 슬롯 div의 ID를 반환합니다.

• 예

  JavaScript

  const slot = googletag
    .defineSlot("/1234567/sports", [160, 600], "div")
    .addService(googletag.pubads());
  
  slot.getSlotElementId();
  // Returns 'div-1'.
  

  자바스크립트 (기존)

  var slot = googletag
    .defineSlot("/1234567/sports", [160, 600], "div")
    .addService(googletag.pubads());
  
  slot.getSlotElementId();
  // Returns 'div-1'.
  

  TypeScript

  const slot = googletag
    .defineSlot("/1234567/sports", [160, 600], "div")!
    .addService(googletag.pubads());
  
  slot.getSlotElementId();
  // Returns 'div-1'.
  

• 반환 값
  string	슬롯 div ID

---

getTargeting

• getTargeting(key: string): string[]

• 이 슬롯에 설정된 특정 맞춤 타겟팅 매개변수를 반환합니다. 서비스 수준 타겟팅 매개변수는 포함되지 않습니다.

• 예

  JavaScript

  const slot = googletag
    .defineSlot("/1234567/sports", [160, 600], "div")
    .setTargeting("allow_expandable", "true")
    .addService(googletag.pubads());
  
  slot.getTargeting("allow_expandable");
  // Returns ['true'].
  
  slot.getTargeting("age");
  // Returns [] (empty array).
  

  자바스크립트 (기존)

  var slot = googletag
    .defineSlot("/1234567/sports", [160, 600], "div")
    .setTargeting("allow_expandable", "true")
    .addService(googletag.pubads());
  
  slot.getTargeting("allow_expandable");
  // Returns ['true'].
  
  slot.getTargeting("age");
  // Returns [] (empty array).
  

  TypeScript

  const slot = googletag
    .defineSlot("/1234567/sports", [160, 600], "div")!
    .setTargeting("allow_expandable", "true")
    .addService(googletag.pubads());
  
  slot.getTargeting("allow_expandable");
  // Returns ['true'].
  
  slot.getTargeting("age");
  // Returns [] (empty array).
  

• 매개변수
  key: string	찾을 타겟팅 키입니다.

• 반환 값
  string[]	이 키와 연결된 값 또는 빈 배열(키가 없는 경우)입니다.

---

getTargetingKeys

• getTargetingKeys(): string[]

• 이 슬롯에 설정된 모든 맞춤 타겟팅 키의 목록을 반환합니다. 서비스 수준 타겟팅 키는 포함되지 않습니다.

• 예

  JavaScript

  const slot = googletag
    .defineSlot("/1234567/sports", [160, 600], "div")
    .setTargeting("allow_expandable", "true")
    .setTargeting("interests", ["sports", "music"])
    .addService(googletag.pubads());
  
  slot.getTargetingKeys();
  // Returns ['interests', 'allow_expandable'].
  

  자바스크립트 (기존)

  var slot = googletag
    .defineSlot("/1234567/sports", [160, 600], "div")
    .setTargeting("allow_expandable", "true")
    .setTargeting("interests", ["sports", "music"])
    .addService(googletag.pubads());
  
  slot.getTargetingKeys();
  // Returns ['interests', 'allow_expandable'].
  

  TypeScript

  const slot = googletag
    .defineSlot("/1234567/sports", [160, 600], "div")!
    .setTargeting("allow_expandable", "true")
    .setTargeting("interests", ["sports", "music"])
    .addService(googletag.pubads());
  
  slot.getTargetingKeys();
  // Returns ['interests', 'allow_expandable'].
  

• 반환 값
  string[]	타겟팅 키의 배열입니다. 순서가 정의되지 않았습니다.

---

set

• set(key: string, value: string): Slot

• 이 광고 슬롯의 애드센스 속성 값을 설정합니다. 이렇게 하면 이 키에 대해 서비스 수준에서 설정된 모든 값이 재정의됩니다.
  
  동일한 키에 대해 이 메서드를 두 번 이상 호출하면 이전에 해당 키에 대해 설정된 값이 재정의됩니다. 모든 값은 display 또는 refresh를 호출하기 전에 설정해야 합니다.

• 예

  JavaScript

  // Setting an attribute on a single ad slot.
  googletag
    .defineSlot("/1234567/sports", [160, 600], "div")
    .set("adsense_background_color", "#FFFFFF")
    .addService(googletag.pubads());
  

  자바스크립트 (기존)

  // Setting an attribute on a single ad slot.
  googletag
    .defineSlot("/1234567/sports", [160, 600], "div")
    .set("adsense_background_color", "#FFFFFF")
    .addService(googletag.pubads());
  

  TypeScript

  // Setting an attribute on a single ad slot.
  googletag
    .defineSlot("/1234567/sports", [160, 600], "div")!
    .set("adsense_background_color", "#FFFFFF")
    .addService(googletag.pubads());
  

  참고 항목

  • 애드센스 속성

• 매개변수
  key: string	속성의 이름입니다.
  value: string	속성 값입니다.

• 반환 값
  Slot	메서드가 호출된 슬롯 객체입니다.

---

setCategoryExclusion

• setCategoryExclusion(categoryExclusion: string): Slot

• 이 슬롯에 슬롯 수준 광고 카테고리 제외 라벨을 설정합니다.

• 예

  JavaScript

  // Label = AirlineAd
  googletag
    .defineSlot("/1234567/sports", [160, 600], "div")
    .setCategoryExclusion("AirlineAd")
    .addService(googletag.pubads());
  

  자바스크립트 (기존)

  // Label = AirlineAd
  googletag
    .defineSlot("/1234567/sports", [160, 600], "div")
    .setCategoryExclusion("AirlineAd")
    .addService(googletag.pubads());
  

  TypeScript

  // Label = AirlineAd
  googletag
    .defineSlot("/1234567/sports", [160, 600], "div")!
    .setCategoryExclusion("AirlineAd")
    .addService(googletag.pubads());
  

  참고 항목

  • 광고를 차단하는 맞춤 라벨

• 매개변수
  categoryExclusion: string	추가할 광고 카테고리 제외 라벨입니다.

• 반환 값
  Slot	메서드가 호출된 슬롯 객체입니다.

---

setClickUrl

• setClickUrl(value: string): Slot

• 광고를 클릭한 사용자가 리디렉션되는 클릭 URL을 설정합니다.
  
  클릭 URL이 대체되더라도 Google Ad Manager 서버는 계속 클릭을 기록합니다. 게재되는 광고 소재와 연결된 모든 방문 페이지 URL이 제공된 값에 추가됩니다. 후속 호출은 값을 덮어씁니다. 이는 SRA가 아닌 요청에서만 작동합니다.

• 예

  JavaScript

  googletag
    .defineSlot("/1234567/sports", [160, 600], "div")
    .setClickUrl("http://www.example.com?original_click_url=")
    .addService(googletag.pubads());
  

  자바스크립트 (기존)

  googletag
    .defineSlot("/1234567/sports", [160, 600], "div")
    .setClickUrl("http://www.example.com?original_click_url=")
    .addService(googletag.pubads());
  

  TypeScript

  googletag
    .defineSlot("/1234567/sports", [160, 600], "div")!
    .setClickUrl("http://www.example.com?original_click_url=")
    .addService(googletag.pubads());
  

• 매개변수
  value: string	설정할 클릭 URL입니다.

• 반환 값
  Slot	메서드가 호출된 슬롯 객체입니다.

---

setCollapseEmptyDiv

• setCollapseEmptyDiv(collapse: boolean, collapseBeforeAdFetch?: boolean): Slot

• 슬롯에 광고가 없을 때 슬롯 div을 숨겨야 하는지 여부를 설정합니다. 이는 서비스 수준 설정보다 우선 적용됩니다.

• 예

  JavaScript

  googletag
    .defineSlot("/1234567/sports", [160, 600], "div-1")
    .setCollapseEmptyDiv(true, true)
    .addService(googletag.pubads());
  // The above will cause the div for this slot to be collapsed
  // when the page is loaded, before ads are requested.
  
  googletag
    .defineSlot("/1234567/sports", [160, 600], "div-2")
    .setCollapseEmptyDiv(true)
    .addService(googletag.pubads());
  // The above will cause the div for this slot to be collapsed
  // only after GPT detects that no ads are available for the slot.
  

  자바스크립트 (기존)

  googletag
    .defineSlot("/1234567/sports", [160, 600], "div-1")
    .setCollapseEmptyDiv(true, true)
    .addService(googletag.pubads());
  // The above will cause the div for this slot to be collapsed
  // when the page is loaded, before ads are requested.
  
  googletag
    .defineSlot("/1234567/sports", [160, 600], "div-2")
    .setCollapseEmptyDiv(true)
    .addService(googletag.pubads());
  // The above will cause the div for this slot to be collapsed
  // only after GPT detects that no ads are available for the slot.
  

  TypeScript

  googletag
    .defineSlot("/1234567/sports", [160, 600], "div-1")!
    .setCollapseEmptyDiv(true, true)
    .addService(googletag.pubads());
  // The above will cause the div for this slot to be collapsed
  // when the page is loaded, before ads are requested.
  
  googletag
    .defineSlot("/1234567/sports", [160, 600], "div-2")!
    .setCollapseEmptyDiv(true)
    .addService(googletag.pubads());
  // The above will cause the div for this slot to be collapsed
  // only after GPT detects that no ads are available for the slot.
  

  참고 항목

  • 빈 광고 슬롯 접기
  • 레이아웃 변경 최소화

• 매개변수
  collapse: boolean	광고가 반환되지 않을 경우 슬롯을 축소할지 여부입니다.
  collapseBeforeAdFetch?: boolean	광고를 가져오기 전에 슬롯을 축소할지 여부입니다. 접기가 true가 아닌 경우 무시됩니다.

• 반환 값
  Slot	메서드가 호출된 슬롯 객체입니다.

---

setConfig

• setConfig(slotConfig: SlotSettingsConfig): void

• 이 슬롯의 일반 구성 옵션을 설정합니다.

• 매개변수
  slotConfig: SlotSettingsConfig	구성 객체입니다.

---

setForceSafeFrame

• setForceSafeFrame(forceSafeFrame: boolean): Slot

• SafeFrame 컨테이너를 사용하여 이 슬롯의 광고를 강제로 렌더링해야 하는지 여부를 구성합니다.
  
  이 API를 사용하는 동안 다음 사항에 유의하세요.

  • 이 설정은 각 슬롯에 대한 후속 광고 요청에만 적용됩니다.
  • 슬롯 수준 설정이 지정된 경우 항상 페이지 수준 설정보다 우선 적용됩니다.
  • true로 설정하면 (슬롯 수준 또는 페이지 수준에서) 광고가 Google Ad Manager UI에서 선택한 사항과 관계없이 항상 SafeFrame 컨테이너를 사용하여 렌더링됩니다.
  • 하지만 false로 설정하거나 지정하지 않은 상태로 두면 광고 소재 유형 및 Google Ad Manager UI에서 선택한 사항에 따라 광고가 SafeFrame 컨테이너를 사용하여 렌더링됩니다.
  • 이 API는 iFrame을 벗어나려고 하거나 게시자 페이지에서 직접 렌더링되어야 하는 광고 소재의 동작에 영향을 미칠 수 있으므로 주의해서 사용해야 합니다.

• 예

  JavaScript

  googletag
    .defineSlot("/1234567/sports", [160, 600], "div")
    .setForceSafeFrame(true)
    .addService(googletag.pubads());
  

  자바스크립트 (기존)

  googletag
    .defineSlot("/1234567/sports", [160, 600], "div")
    .setForceSafeFrame(true)
    .addService(googletag.pubads());
  

  TypeScript

  googletag
    .defineSlot("/1234567/sports", [160, 600], "div")!
    .setForceSafeFrame(true)
    .addService(googletag.pubads());
  

  참고 항목

  • SafeFrame을 사용하여 광고 소재 렌더링하기

• 매개변수
  forceSafeFrame: boolean	true는 이 슬롯의 모든 광고를 SafeFrame에서 렌더링하도록 강제하고 false는 페이지 수준 설정 (있는 경우)을 선택 해제합니다. 페이지 수준에서 지정되지 않은 경우 이를 false로 설정해도 변경되는 사항은 없습니다.

• 반환 값
  Slot	메서드가 호출된 슬롯 객체입니다.

---

setSafeFrameConfig

• setSafeFrameConfig(config: null | SafeFrameConfig): Slot

• SafeFrame 구성에 대한 슬롯 수준 환경설정을 설정합니다. 구성 객체에서 인식할 수 없는 키는 무시됩니다. 인식된 키에 잘못된 값이 전달되면 전체 구성이 무시됩니다.
  
  이러한 슬롯 수준 환경설정이 지정된 경우 모든 페이지 수준 환경설정이 재정의됩니다.

• 예

  JavaScript

  googletag.pubads().setForceSafeFrame(true);
  
  // The following slot will have a sandboxed safeframe that only
  // disallows top-level navigation.
  googletag
    .defineSlot("/1234567/sports", [160, 600], "div-1")
    .setSafeFrameConfig({ sandbox: true })
    .addService(googletag.pubads());
  
  // The following slot will inherit page-level settings.
  googletag.defineSlot("/1234567/news", [160, 600], "div-2").addService(googletag.pubads());
  
  googletag.display("div-1");
  googletag.display("div-2");
  

  자바스크립트 (기존)

  googletag.pubads().setForceSafeFrame(true);
  
  // The following slot will have a sandboxed safeframe that only
  // disallows top-level navigation.
  googletag
    .defineSlot("/1234567/sports", [160, 600], "div-1")
    .setSafeFrameConfig({ sandbox: true })
    .addService(googletag.pubads());
  
  // The following slot will inherit page-level settings.
  googletag.defineSlot("/1234567/news", [160, 600], "div-2").addService(googletag.pubads());
  
  googletag.display("div-1");
  googletag.display("div-2");
  

  TypeScript

  googletag.pubads().setForceSafeFrame(true);
  
  // The following slot will have a sandboxed safeframe that only
  // disallows top-level navigation.
  googletag
    .defineSlot("/1234567/sports", [160, 600], "div-1")!
    .setSafeFrameConfig({ sandbox: true })
    .addService(googletag.pubads());
  
  // The following slot will inherit page-level settings.
  googletag.defineSlot("/1234567/news", [160, 600], "div-2")!.addService(googletag.pubads());
  
  googletag.display("div-1");
  googletag.display("div-2");
  

  참고 항목

  • SafeFrame을 사용하여 광고 소재 렌더링하기

• 매개변수
  config: null | SafeFrameConfig	구성 객체입니다.

• 반환 값
  Slot	메서드가 호출된 슬롯 객체입니다.

---

setTargeting

• setTargeting(key: string, value: string | string[]): Slot

• 이 슬롯에 맞춤 타겟팅 매개변수를 설정합니다. 동일한 키에 대해 이 메서드를 여러 번 호출하면 이전 값을 덮어씁니다. 여기에서 설정된 값은 서비스 수준에서 설정된 타겟팅 매개변수를 덮어씁니다. 이러한 키는 Google Ad Manager 계정에서 정의됩니다.

• 예

  JavaScript

  const slot = googletag
    .defineSlot("/1234567/sports", [160, 600], "div")
    .addService(googletag.pubads());
  
  // Example with a single value for a key.
  slot.setTargeting("allow_expandable", "true");
  
  // Example with multiple values for a key inside in an array.
  slot.setTargeting("interests", ["sports", "music"]);
  

  자바스크립트 (기존)

  var slot = googletag
    .defineSlot("/1234567/sports", [160, 600], "div")
    .addService(googletag.pubads());
  
  // Example with a single value for a key.
  slot.setTargeting("allow_expandable", "true");
  
  // Example with multiple values for a key inside in an array.
  slot.setTargeting("interests", ["sports", "music"]);
  

  TypeScript

  const slot = googletag
    .defineSlot("/1234567/sports", [160, 600], "div")!
    .addService(googletag.pubads());
  
  // Example with a single value for a key.
  slot.setTargeting("allow_expandable", "true");
  
  // Example with multiple values for a key inside in an array.
  slot.setTargeting("interests", ["sports", "music"]);
  

  참고 항목

  • 키-값 타겟팅

• 매개변수
  key: string	타겟팅 매개변수 키.
  value: string | string[]	타겟팅 매개변수 값 또는 값의 배열입니다.

• 반환 값
  Slot	메서드가 호출된 슬롯 객체입니다.

---

updateTargetingFromMap

• updateTargetingFromMap(map: {  [adUnitPath: string]: string | string[] }): Slot

• JSON 객체의 키:값 맵에서 이 슬롯의 맞춤 타겟팅 매개변수를 설정합니다. 객체의 모든 키 값에 Slot.setTargeting를 호출하는 것과 같습니다. 이러한 키는 Google Ad Manager 계정에 정의되어 있습니다.
  
  참고:

  • 덮어쓸 경우 마지막 값만 유지됩니다.
  • 값이 배열인 경우 이전 값은 병합되지 않고 덮어씁니다.
  • 여기에서 설정된 값은 서비스 수준에서 설정된 타겟팅 매개변수를 덮어씁니다.

• 예

  JavaScript

  const slot = googletag.defineSlot("/1234567/sports", [160, 600], "div");
  
  slot.updateTargetingFromMap({
    color: "red",
    interests: ["sports", "music", "movies"],
  });
  

  자바스크립트 (기존)

  var slot = googletag.defineSlot("/1234567/sports", [160, 600], "div");
  
  slot.updateTargetingFromMap({
    color: "red",
    interests: ["sports", "music", "movies"],
  });
  

  TypeScript

  const slot = googletag.defineSlot("/1234567/sports", [160, 600], "div")!;
  
  slot.updateTargetingFromMap({
    color: "red",
    interests: ["sports", "music", "movies"],
  });
  

• 매개변수
  map: {  [adUnitPath: string]: string | string[] }	타겟팅 매개변수 키:값 맵입니다.

• 반환 값
  Slot	메서드가 호출된 슬롯 객체입니다.

---

googletag.configAdExpansionConfig

광고 확장을 제어하기 위한 설정입니다.

속성 요약
enabled	광고 확장의 사용 설정 여부입니다.

예

JavaScript

// Enable ad slot expansion across the entire page.
googletag.setConfig({
  adExpansion: { enabled: true },
});

자바스크립트 (기존)

// Enable ad slot expansion across the entire page.
googletag.setConfig({
  adExpansion: { enabled: true },
});

TypeScript

// Enable ad slot expansion across the entire page.
googletag.setConfig({
  adExpansion: { enabled: true },
});

---

enabled

• enabled: boolean

• 광고 확장의 사용 설정 또는 사용 중지 여부입니다.
  
  이 값을 설정하면 Google Ad Manager에 설정된 기본값이 재정의됩니다.

• 참고 항목

  • 데스크톱 및 태블릿에서 광고 확장
  • 모바일 웹에서 광고 펼치기 (부분 화면)

---

googletag.configComponentAuctionConfig

기기 내 광고 입찰의 단일 구성요소 입찰을 나타내는 객체입니다.

속성 요약
auctionConfig	구성요소 입찰의 입찰 구성 객체입니다.
configKey	구성요소 입찰과 연결된 구성 키입니다.

참고 항목

• Protected Audience API 판매자 가이드: 광고 입찰 실행

---

auctionConfig

• auctionConfig: null | { auctionSignals: unknown, decisionLogicUrl: string, interestGroupBuyers: string[], perBuyerExperimentGroupIds: {  [buyer: string]: number }, perBuyerGroupLimits: {  [buyer: string]: number }, perBuyerSignals: {  [buyer: string]: unknown }, perBuyerTimeouts: {  [buyer: string]: number }, seller: string, sellerExperimentGroupId: number, sellerSignals: unknown, sellerTimeout: number, trustedScoringSignalsUrl: string }

• 구성요소 입찰의 입찰 구성 객체입니다.
  
  이 값이 null(으)로 설정되면 지정된 configKey의 기존 구성이 삭제됩니다.

• 예

  JavaScript

  const componentAuctionConfig = {
    // Seller URL should be https and the same as decisionLogicUrl's origin
    seller: "https://testSeller.com",
    decisionLogicUrl: "https://testSeller.com/ssp/decision-logic.js",
    interestGroupBuyers: ["https://example-buyer.com"],
    auctionSignals: { auction_signals: "auction_signals" },
    sellerSignals: { seller_signals: "seller_signals" },
    perBuyerSignals: {
      // listed on interestGroupBuyers
      "https://example-buyer.com": {
        per_buyer_signals: "per_buyer_signals",
      },
    },
  };
  
  const auctionSlot = googletag.defineSlot("/1234567/example", [160, 600]);
  
  // To add configKey to the component auction:
  auctionSlot.setConfig({
    componentAuction: [
      {
        configKey: "https://testSeller.com",
        auctionConfig: componentAuctionConfig,
      },
    ],
  });
  
  // To remove configKey from the component auction:
  auctionSlot.setConfig({
    componentAuction: [
      {
        configKey: "https://testSeller.com",
        auctionConfig: null,
      },
    ],
  });
  

  자바스크립트 (기존)

  var componentAuctionConfig = {
    // Seller URL should be https and the same as decisionLogicUrl's origin
    seller: "https://testSeller.com",
    decisionLogicUrl: "https://testSeller.com/ssp/decision-logic.js",
    interestGroupBuyers: ["https://example-buyer.com"],
    auctionSignals: { auction_signals: "auction_signals" },
    sellerSignals: { seller_signals: "seller_signals" },
    perBuyerSignals: {
      // listed on interestGroupBuyers
      "https://example-buyer.com": {
        per_buyer_signals: "per_buyer_signals",
      },
    },
  };
  
  var auctionSlot = googletag.defineSlot("/1234567/example", [160, 600]);
  
  // To add configKey to the component auction:
  auctionSlot.setConfig({
    componentAuction: [
      {
        configKey: "https://testSeller.com",
        auctionConfig: componentAuctionConfig,
      },
    ],
  });
  
  // To remove configKey from the component auction:
  auctionSlot.setConfig({
    componentAuction: [
      {
        configKey: "https://testSeller.com",
        auctionConfig: null,
      },
    ],
  });
  

  TypeScript

  const componentAuctionConfig = {
    // Seller URL should be https and the same as decisionLogicUrl's origin
    seller: "https://testSeller.com",
    decisionLogicUrl: "https://testSeller.com/ssp/decision-logic.js",
    interestGroupBuyers: ["https://example-buyer.com"],
    auctionSignals: { auction_signals: "auction_signals" },
    sellerSignals: { seller_signals: "seller_signals" },
    perBuyerSignals: {
      // listed on interestGroupBuyers
      "https://example-buyer.com": {
        per_buyer_signals: "per_buyer_signals",
      },
    },
  };
  
  const auctionSlot = googletag.defineSlot("/1234567/example", [160, 600])!;
  
  // To add configKey to the component auction:
  auctionSlot.setConfig({
    componentAuction: [
      {
        configKey: "https://testSeller.com",
        auctionConfig: componentAuctionConfig,
      },
    ],
  });
  
  // To remove configKey from the component auction:
  auctionSlot.setConfig({
    componentAuction: [
      {
        configKey: "https://testSeller.com",
        auctionConfig: null,
      },
    ],
  });
  

  참고 항목

  • Protected Audience API: 기기 내 입찰 시작

---

configKey

• configKey: string

• 이 구성요소 입찰과 연결된 구성 키입니다.
  
  이 값은 비어 있지 않아야 하며 고유해야 합니다. 두 개의 ComponentAuctionConfig 객체가 동일한 configKey 값을 공유하는 경우 마지막으로 설정할 객체가 이전 구성을 덮어씁니다.

---

googletag.configInterstitialConfig

단일 전면 광고 슬롯의 동작을 정의하는 객체입니다.

속성 요약
triggers	이 전면 광고에 대한 전면 광고 트리거 구성입니다.

---

triggers

• triggers: Partial<Record<InterstitialTrigger, boolean>>

• 이 전면 광고에 대한 전면 광고 트리거 구성입니다.
  
  전면 광고 트리거의 값을 true(으)로 설정하면 전면 광고 트리거가 사용 설정되고 false(으)로 인해 사용 중지됩니다. 이렇게 하면 Google Ad Manager에서 구성된 기본값이 재정의됩니다.

• 예

  JavaScript

  // Define a GPT managed web interstitial ad slot.
  const interstitialSlot = googletag.defineOutOfPageSlot(
    "/1234567/sports",
    googletag.enums.OutOfPageFormat.INTERSTITIAL
  );
  
  // Enable optional interstitial triggers.
  // Change this value to false to disable.
  const enableTriggers = true;
  
  interstitialSlot.setConfig({
    interstitial: {
      triggers: {
        navBar: enableTriggers,
        unhideWindow: enableTriggers,
      },
    },
  });
  

  자바스크립트 (기존)

  // Define a GPT managed web interstitial ad slot.
  var interstitialSlot = googletag.defineOutOfPageSlot(
    "/1234567/sports",
    googletag.enums.OutOfPageFormat.INTERSTITIAL
  );
  
  // Enable optional interstitial triggers.
  // Change this value to false to disable.
  var enableTriggers = true;
  
  interstitialSlot.setConfig({
    interstitial: {
      triggers: {
        navBar: enableTriggers,
        unhideWindow: enableTriggers,
      },
    },
  });
  

  TypeScript

  // Define a GPT managed web interstitial ad slot.
  const interstitialSlot = googletag.defineOutOfPageSlot(
    "/1234567/sports",
    googletag.enums.OutOfPageFormat.INTERSTITIAL
  )!;
  
  // Enable optional interstitial triggers.
  // Change this value to false to disable.
  const enableTriggers = true;
  
  interstitialSlot.setConfig({
    interstitial: {
      triggers: {
        navBar: enableTriggers,
        unhideWindow: enableTriggers,
      },
    },
  });
  

  참고 항목

  • 웹 전면 광고 표시

---

googletag.configPageSettingsConfig

페이지 수준 설정을 위한 기본 구성 인터페이스입니다.

한 번의 API 호출로 여러 기능을 설정할 수 있습니다.

아래 나열된 모든 속성은 예시이며 setConfig를 활용하는 실제 기능을 반영하지 않습니다. 기능 집합은 아래 PageSettingsConfig 유형 내의 필드를 참고하세요.

예:

• setConfig 호출에 지정된 지형지물만 수정됩니다.

    // Configure feature alpha.
    googletag.setConfig({
        alpha: {...}
    });
  
    // Configure feature bravo. Feature alpha is unchanged.
    googletag.setConfig({
       bravo: {...}
    });
  

• 특정 기능의 모든 설정은 setConfig를 호출할 때마다 업데이트됩니다.

    // Configure feature charlie to echo = 1, foxtrot = true.
    googletag.setConfig({
        charlie: {
            echo: 1,
            foxtrot: true,
        }
    });
  
    // Update feature charlie to echo = 2. Since foxtrot was not specified,
    // the value is cleared.
    googletag.setConfig({
        charlie: {
            echo: 2
        }
    });
  

• 특정 기능의 모든 설정은 null.

    // Configure features delta, golf, and hotel.
    googletag.setConfig({
        delta: {...},
        golf: {...},
        hotel: {...},
    });
  
    // Feature delta and hotel are cleared, but feature golf remains set.
    googletag.setConfig({
        delta: null,
        hotel: null,
    });
  

  를 전달하여 삭제할 수 있습니다.

속성 요약
adExpansion	광고 확장을 제어하기 위한 설정입니다.
pps	게시자 제공 신호 (PPS)를 제어하기 위한 설정입니다.
privacyTreatments	게시자 개인 정보 보호 처리를 제어하기 위한 설정입니다.

---

adExpansion

• adExpansion: null | AdExpansionConfig

• 광고 확장을 제어하기 위한 설정입니다.

---

pps

• pps: null | PublisherProvidedSignalsConfig

• 게시자 제공 신호 (PPS)를 제어하기 위한 설정입니다.

---

privacyTreatments

• privacyTreatments: null | PrivacyTreatmentsConfig

• 게시자 개인 정보 보호 처리를 제어하기 위한 설정입니다.

---

googletag.configPrivacyTreatmentsConfig

게시자 개인 정보 보호 처리를 제어하기 위한 설정입니다.

속성 요약
treatments	사용 설정할 게시자 개인 정보 보호 처리의 배열입니다.

---

treatments

• treatments: "disablePersonalization"[]

• 사용 설정할 게시자 개인 정보 보호 처리의 배열입니다.

• 예

  JavaScript

  // Disable personalization across the entire page.
  googletag.setConfig({
    privacyTreatments: { treatments: ["disablePersonalization"] },
  });
  

  자바스크립트 (기존)

  // Disable personalization across the entire page.
  googletag.setConfig({
    privacyTreatments: { treatments: ["disablePersonalization"] },
  });
  

  TypeScript

  // Disable personalization across the entire page.
  googletag.setConfig({
    privacyTreatments: { treatments: ["disablePersonalization"] },
  });
  

---

googletag.configPublisherProvidedSignalsConfig

게시자 제공 신호 (PPS) 구성 객체입니다.

속성 요약
taxonomies	분류 매핑이 포함된 객체입니다.

예

JavaScript

googletag.setConfig({
  pps: {
    taxonomies: {
      IAB_AUDIENCE_1_1: { values: ["6", "626"] },
      // '6' = 'Demographic | Age Range | 18-20'
      // '626' = 'Interest | Sports | Darts'
      IAB_CONTENT_2_2: { values: ["48", "127"] },
      // '48' = 'Books and Literature | Fiction'
      // '127' = 'Careers | Job Search'
    },
  },
});

자바스크립트 (기존)

googletag.setConfig({
  pps: {
    taxonomies: {
      IAB_AUDIENCE_1_1: { values: ["6", "626"] },
      // '6' = 'Demographic | Age Range | 18-20'
      // '626' = 'Interest | Sports | Darts'
      IAB_CONTENT_2_2: { values: ["48", "127"] },
      // '48' = 'Books and Literature | Fiction'
      // '127' = 'Careers | Job Search'
    },
  },
});

TypeScript

googletag.setConfig({
  pps: {
    taxonomies: {
      IAB_AUDIENCE_1_1: { values: ["6", "626"] },
      // '6' = 'Demographic | Age Range | 18-20'
      // '626' = 'Interest | Sports | Darts'
      IAB_CONTENT_2_2: { values: ["48", "127"] },
      // '48' = 'Books and Literature | Fiction'
      // '127' = 'Careers | Job Search'
    },
  },
});

참고 항목

• 게시자 제공 신호에 대한 정보 (베타)
• IAB 잠재고객 분류 1.1
• IAB 콘텐츠 분류 2.2

---

taxonomies

• taxonomies: Partial<Record<Taxonomy, TaxonomyData>>

• 분류 매핑이 포함된 객체입니다.

---

googletag.configSlotSettingsConfig

슬롯 수준 설정을 위한 기본 구성 인터페이스입니다.

단일 슬롯에 단일 API 호출로 여러 기능을 설정할 수 있습니다.

아래 나열된 모든 속성은 예시이며 setConfig를 활용하는 실제 기능을 반영하지 않습니다. 기능 집합은 아래 SlotSettingsConfig 유형 내의 필드를 참고하세요.

예:

• Slot.setConfig 호출에 지정된 지형지물만 수정됩니다.

    const slot = googletag.defineSlot("/1234567/example", [160, 600]);
  
    // Configure feature alpha.
    slot.setConfig({
        alpha: {...}
    });
  
    // Configure feature bravo. Feature alpha is unchanged.
    slot.setConfig({
       bravo: {...}
    });
  

• 특정 기능의 모든 설정은 Slot.setConfig를 호출할 때마다 업데이트됩니다.

    // Configure feature charlie to echo = 1, foxtrot = true.
    slot.setConfig({
        charlie: {
            echo: 1,
            foxtrot: true,
        }
    });
  
    // Update feature charlie to echo = 2. Since foxtrot was not specified,
    // the value is cleared.
    slot.setConfig({
        charlie: {
            echo: 2
        }
    });
  

• 특정 기능의 모든 설정은 null.

    // Configure features delta, golf, and hotel.
    slot.setConfig({
        delta: {...},
        golf: {...},
        hotel: {...},
    });
  
    // Feature delta and hotel are cleared, but feature golf remains set.
    slot.setConfig({
        delta: null,
        hotel: null,
    });
  

  를 전달하여 삭제할 수 있습니다.

속성 요약
adExpansion	광고 확장을 제어하기 위한 설정입니다.
componentAuction	기기 내 광고 입찰에 포함될 구성요소 입찰의 배열입니다.
interstitial	전면 광고 슬롯 동작을 제어하는 설정입니다.

---

adExpansion

• adExpansion: AdExpansionConfig

• 광고 확장을 제어하기 위한 설정입니다.

---

componentAuction

• componentAuction: ComponentAuctionConfig[]

• 기기 내 광고 입찰에 포함될 구성요소 입찰의 배열입니다.

---

interstitial

• interstitial: InterstitialConfig

• 전면 광고 슬롯 동작을 제어하는 설정입니다.

---

googletag.configTaxonomyData

단일 분류 값이 포함된 객체입니다.

속성 요약
values	분류 값의 목록입니다.

---

values

• values: string[]

• 분류 값의 목록입니다.

---

googletag.eventsEvent

모든 GPT 이벤트에 대한 기본 인터페이스입니다. 아래의 모든 GPT 이벤트에는 다음과 같은 필드가 있습니다.

속성 요약
serviceName	이벤트를 트리거한 서비스의 이름입니다.
slot	이벤트를 트리거한 슬롯입니다.

참고 항목

• 광고 이벤트 리스너

---

serviceName

• serviceName: string

• 이벤트를 트리거한 서비스의 이름입니다.

---

slot

• slot: Slot

• 이벤트를 트리거한 슬롯입니다.

---

googletag.eventsEventTypeMap

이벤트 이름을 Service.addEventListener 및 Service.removeEventListener에 해당하는 이벤트 객체 유형에 매핑하는 유사 유형입니다. 참조 및 유형 안전성 목적으로만 문서화됩니다.

속성 요약
impressionViewable	events.ImpressionViewableEvent의 별칭입니다.
rewardedSlotClosed	events.RewardedSlotClosedEvent의 별칭입니다.
rewardedSlotGranted	events.RewardedSlotGrantedEvent의 별칭입니다.
rewardedSlotReady	events.RewardedSlotReadyEvent의 별칭입니다.
slotOnload	events.SlotOnloadEvent의 별칭입니다.
slotRenderEnded	events.SlotRenderEndedEvent의 별칭입니다.
slotRequested	events.SlotRequestedEvent의 별칭입니다.
slotResponseReceived	events.SlotResponseReceived의 별칭입니다.
slotVisibilityChanged	events.SlotVisibilityChangedEvent의 별칭입니다.

---

impressionViewable

• impressionViewable: ImpressionViewableEvent

• events.ImpressionViewableEvent의 별칭입니다.

---

rewardedSlotClosed

• rewardedSlotClosed: RewardedSlotClosedEvent

• events.RewardedSlotClosedEvent의 별칭입니다.

---

rewardedSlotGranted

• rewardedSlotGranted: RewardedSlotGrantedEvent

• events.RewardedSlotGrantedEvent의 별칭입니다.

---

rewardedSlotReady

• rewardedSlotReady: RewardedSlotReadyEvent

• events.RewardedSlotReadyEvent의 별칭입니다.

---

slotOnload

• slotOnload: SlotOnloadEvent

• events.SlotOnloadEvent의 별칭입니다.

---

slotRenderEnded

• slotRenderEnded: SlotRenderEndedEvent

• events.SlotRenderEndedEvent의 별칭입니다.

---

slotRequested

• slotRequested: SlotRequestedEvent

• events.SlotRequestedEvent의 별칭입니다.

---

slotResponseReceived

• slotResponseReceived: SlotResponseReceived

• events.SlotResponseReceived의 별칭입니다.

---

slotVisibilityChanged

• slotVisibilityChanged: SlotVisibilityChangedEvent

• events.SlotVisibilityChangedEvent의 별칭입니다.

---

googletag.eventsImpressionViewableEvent

Event를 확장합니다.

이 이벤트는 Active View 기준에 따라 노출이 조회 가능해지면 시작됩니다.

속성 요약
serviceName	이벤트를 트리거한 서비스의 이름입니다. googletag.events.Event.serviceName에서 상속됨
slot	이벤트를 트리거한 슬롯입니다. googletag.events.Event.slot에서 상속됨

예

JavaScript

// This listener is called when an impression becomes viewable.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("impressionViewable", (event) => {
  const slot = event.slot;
  console.log("Impression for slot", slot.getSlotElementId(), "became viewable.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

자바스크립트 (기존)

// This listener is called when an impression becomes viewable.
var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("impressionViewable", function (event) {
  var slot = event.slot;
  console.log("Impression for slot", slot.getSlotElementId(), "became viewable.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

TypeScript

// This listener is called when an impression becomes viewable.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("impressionViewable", (event) => {
  const slot = event.slot;
  console.log("Impression for slot", slot.getSlotElementId(), "became viewable.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

참고 항목

• 광고 이벤트 리스너

---

googletag.eventsRewardedSlotClosedEvent

Event를 확장합니다.

이 이벤트는 사용자가 보상형 광고 슬롯을 닫으면 시작됩니다. 리워드가 부여되기 전이나 후에 실행될 수 있습니다. 리워드가 지급되었는지 확인하려면 events.RewardedSlotGrantedEvent를 대신 사용하세요.

속성 요약
serviceName	이벤트를 트리거한 서비스의 이름입니다. googletag.events.Event.serviceName에서 상속됨
slot	이벤트를 트리거한 슬롯입니다. googletag.events.Event.slot에서 상속됨

예

JavaScript

// This listener is called when the user closes a rewarded ad slot.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("rewardedSlotClosed", (event) => {
  const slot = event.slot;
  console.log("Rewarded ad slot", slot.getSlotElementId(), "has been closed.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

자바스크립트 (기존)

// This listener is called when the user closes a rewarded ad slot.
var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("rewardedSlotClosed", function (event) {
  var slot = event.slot;
  console.log("Rewarded ad slot", slot.getSlotElementId(), "has been closed.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

TypeScript

// This listener is called when the user closes a rewarded ad slot.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("rewardedSlotClosed", (event) => {
  const slot = event.slot;
  console.log("Rewarded ad slot", slot.getSlotElementId(), "has been closed.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

참고 항목

• 광고 이벤트 리스너
• 보상형 광고 표시

---

googletag.eventsRewardedSlotGrantedEvent

Event를 확장합니다.

이 이벤트는 보상형 광고를 시청하여 리워드가 제공되면 시작됩니다. 보상 제공 기준이 충족되기 전에 광고를 닫으면 이 이벤트가 실행되지 않습니다.

속성 요약
payload	부여된 리워드에 대한 정보가 포함된 객체입니다.
serviceName	이벤트를 트리거한 서비스의 이름입니다. googletag.events.Event.serviceName에서 상속됨
slot	이벤트를 트리거한 슬롯입니다. googletag.events.Event.slot에서 상속됨

예

JavaScript

// This listener is called whenever a reward is granted for a
// rewarded ad.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("rewardedSlotGranted", (event) => {
  const slot = event.slot;
  console.group("Reward granted for slot", slot.getSlotElementId(), ".");

  // Log details of the reward.
  console.log("Reward type:", event.payload?.type);
  console.log("Reward amount:", event.payload?.amount);
  console.groupEnd();

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

자바스크립트 (기존)

// This listener is called whenever a reward is granted for a
// rewarded ad.
var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("rewardedSlotGranted", function (event) {
  var _a, _b;
  var slot = event.slot;
  console.group("Reward granted for slot", slot.getSlotElementId(), ".");

  // Log details of the reward.
  console.log("Reward type:", (_a = event.payload) === null || _a === void 0 ? void 0 : _a.type);
  console.log(
    "Reward amount:",
    (_b = event.payload) === null || _b === void 0 ? void 0 : _b.amount
  );
  console.groupEnd();

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

TypeScript

// This listener is called whenever a reward is granted for a
// rewarded ad.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("rewardedSlotGranted", (event) => {
  const slot = event.slot;
  console.group("Reward granted for slot", slot.getSlotElementId(), ".");

  // Log details of the reward.
  console.log("Reward type:", event.payload?.type);
  console.log("Reward amount:", event.payload?.amount);
  console.groupEnd();

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

참고 항목

• 광고 이벤트 리스너
• 보상형 광고 표시

---

payload

• payload: null | RewardedPayload

• 부여된 리워드에 대한 정보가 포함된 객체입니다.

---

googletag.eventsRewardedSlotReadyEvent

Event를 확장합니다.

이 이벤트는 보상형 광고를 게재할 준비가 되면 시작됩니다. 게시자는 광고를 표시하기 전에 볼 수 있는 옵션을 사용자에게 제공해야 합니다.

속성 요약
serviceName	이벤트를 트리거한 서비스의 이름입니다. googletag.events.Event.serviceName에서 상속됨
slot	이벤트를 트리거한 슬롯입니다. googletag.events.Event.slot에서 상속됨

메서드 요약
makeRewardedVisible	보상형 광고를 표시합니다.

예

JavaScript

// This listener is called when a rewarded ad slot becomes ready to be
// displayed.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("rewardedSlotReady", (event) => {
  const slot = event.slot;
  console.log("Rewarded ad slot", slot.getSlotElementId(), "is ready to be displayed.");

  // Replace with custom logic.
  const userHasConsented = true;
  if (userHasConsented) {
    event.makeRewardedVisible();
  }

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

자바스크립트 (기존)

// This listener is called when a rewarded ad slot becomes ready to be
// displayed.
var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("rewardedSlotReady", function (event) {
  var slot = event.slot;
  console.log("Rewarded ad slot", slot.getSlotElementId(), "is ready to be displayed.");

  // Replace with custom logic.
  var userHasConsented = true;
  if (userHasConsented) {
    event.makeRewardedVisible();
  }

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

TypeScript

// This listener is called when a rewarded ad slot becomes ready to be
// displayed.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("rewardedSlotReady", (event) => {
  const slot = event.slot;
  console.log("Rewarded ad slot", slot.getSlotElementId(), "is ready to be displayed.");

  // Replace with custom logic.
  const userHasConsented = true;
  if (userHasConsented) {
    event.makeRewardedVisible();
  }

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

참고 항목

• 광고 이벤트 리스너
• 보상형 광고 표시

---

makeRewardedVisible

• makeRewardedVisible(): void

• 보상형 광고를 표시합니다. 사용자가 광고 보기에 동의할 때까지 이 메서드를 호출하면 안 됩니다.

---

googletag.eventsSlotOnloadEvent

Event를 확장합니다.

이 이벤트는 광고 소재의 iframe이 로드 이벤트를 실행하면 시작됩니다. 동기화 렌더링 모드에서 리치 미디어 광고를 렌더링할 때는 iframe을 사용하지 않으므로 SlotOnloadEvent이 실행되지 않습니다.

속성 요약
serviceName	이벤트를 트리거한 서비스의 이름입니다. googletag.events.Event.serviceName에서 상속됨
slot	이벤트를 트리거한 슬롯입니다. googletag.events.Event.slot에서 상속됨

예

JavaScript

// This listener is called when a creative iframe load event fires.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotOnload", (event) => {
  const slot = event.slot;
  console.log("Creative iframe for slot", slot.getSlotElementId(), "has loaded.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

자바스크립트 (기존)

// This listener is called when a creative iframe load event fires.
var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotOnload", function (event) {
  var slot = event.slot;
  console.log("Creative iframe for slot", slot.getSlotElementId(), "has loaded.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

TypeScript

// This listener is called when a creative iframe load event fires.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotOnload", (event) => {
  const slot = event.slot;
  console.log("Creative iframe for slot", slot.getSlotElementId(), "has loaded.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

참고 항목

• 광고 이벤트 리스너

---

googletag.eventsSlotRenderEndedEvent

Event를 확장합니다.

이 이벤트는 광고 소재 코드가 슬롯에 삽입되면 시작됩니다. 이 이벤트는 광고 소재의 리소스를 가져오기 전에 발생하므로 광고 소재가 아직 표시되지 않을 수 있습니다. 슬롯의 모든 광고 소재 리소스의 로드가 완료된 시점을 알아야 하는 경우에는 events.SlotOnloadEvent를 사용하는 것이 좋습니다.

속성 요약
advertiserId	렌더링된 광고의 광고주 ID입니다.
campaignId	렌더링된 광고의 캠페인 ID입니다.
companyIds	렌더링된 백업 광고에 입찰하는 회사의 ID입니다.
creativeId	렌더링된 예약 광고의 광고 소재 ID입니다.
creativeTemplateId	렌더링된 예약 광고의 광고 소재 템플릿 ID입니다.
isBackfill	광고가 백업 광고인지 여부입니다.
isEmpty	슬롯에 대해 광고가 반환되었는지 여부입니다.
labelIds	렌더링된 광고의 라벨 ID입니다.
lineItemId	렌더링된 예약 광고의 광고 항목 ID입니다.
serviceName	이벤트를 트리거한 서비스의 이름입니다. googletag.events.Event.serviceName에서 상속됨
size	렌더링된 광고 소재의 픽셀 크기를 나타냅니다.
slot	이벤트를 트리거한 슬롯입니다. googletag.events.Event.slot에서 상속됨
slotContentChanged	슬롯 콘텐츠가 렌더링된 광고로 변경되었는지 여부입니다.
sourceAgnosticCreativeId	렌더링된 예약 또는 백업 광고의 광고 소재 ID입니다.
sourceAgnosticLineItemId	렌더링된 예약 또는 백업 광고의 광고 항목 ID입니다.
yieldGroupIds	렌더링된 백업 광고의 수익 그룹 ID입니다.

예

JavaScript

// This listener is called when a slot has finished rendering.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotRenderEnded", (event) => {
  const slot = event.slot;
  console.group("Slot", slot.getSlotElementId(), "finished rendering.");

  // Log details of the rendered ad.
  console.log("Advertiser ID:", event.advertiserId);
  console.log("Campaign ID:", event.campaignId);
  console.log("Company IDs:", event.companyIds);
  console.log("Creative ID:", event.creativeId);
  console.log("Creative Template ID:", event.creativeTemplateId);
  console.log("Is backfill?:", event.isBackfill);
  console.log("Is empty?:", event.isEmpty);
  console.log("Label IDs:", event.labelIds);
  console.log("Line Item ID:", event.lineItemId);
  console.log("Size:", event.size);
  console.log("Slot content changed?", event.slotContentChanged);
  console.log("Source Agnostic Creative ID:", event.sourceAgnosticCreativeId);
  console.log("Source Agnostic Line Item ID:", event.sourceAgnosticLineItemId);
  console.log("Yield Group IDs:", event.yieldGroupIds);
  console.groupEnd();

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

자바스크립트 (기존)

// This listener is called when a slot has finished rendering.
var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotRenderEnded", function (event) {
  var slot = event.slot;
  console.group("Slot", slot.getSlotElementId(), "finished rendering.");

  // Log details of the rendered ad.
  console.log("Advertiser ID:", event.advertiserId);
  console.log("Campaign ID:", event.campaignId);
  console.log("Company IDs:", event.companyIds);
  console.log("Creative ID:", event.creativeId);
  console.log("Creative Template ID:", event.creativeTemplateId);
  console.log("Is backfill?:", event.isBackfill);
  console.log("Is empty?:", event.isEmpty);
  console.log("Label IDs:", event.labelIds);
  console.log("Line Item ID:", event.lineItemId);
  console.log("Size:", event.size);
  console.log("Slot content changed?", event.slotContentChanged);
  console.log("Source Agnostic Creative ID:", event.sourceAgnosticCreativeId);
  console.log("Source Agnostic Line Item ID:", event.sourceAgnosticLineItemId);
  console.log("Yield Group IDs:", event.yieldGroupIds);
  console.groupEnd();

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

TypeScript

// This listener is called when a slot has finished rendering.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotRenderEnded", (event) => {
  const slot = event.slot;
  console.group("Slot", slot.getSlotElementId(), "finished rendering.");

  // Log details of the rendered ad.
  console.log("Advertiser ID:", event.advertiserId);
  console.log("Campaign ID:", event.campaignId);
  console.log("Company IDs:", event.companyIds);
  console.log("Creative ID:", event.creativeId);
  console.log("Creative Template ID:", event.creativeTemplateId);
  console.log("Is backfill?:", event.isBackfill);
  console.log("Is empty?:", event.isEmpty);
  console.log("Label IDs:", event.labelIds);
  console.log("Line Item ID:", event.lineItemId);
  console.log("Size:", event.size);
  console.log("Slot content changed?", event.slotContentChanged);
  console.log("Source Agnostic Creative ID:", event.sourceAgnosticCreativeId);
  console.log("Source Agnostic Line Item ID:", event.sourceAgnosticLineItemId);
  console.log("Yield Group IDs:", event.yieldGroupIds);
  console.groupEnd();

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

참고 항목

• 광고 이벤트 리스너

---

advertiserId

• advertiserId: null | number

• 렌더링된 광고의 광고주 ID입니다. 빈 슬롯, 백업 광고, PubAdsService 이외의 서비스에서 렌더링된 광고 소재의 경우 값은 null입니다.

---

campaignId

• campaignId: null | number

• 렌더링된 광고의 캠페인 ID입니다. 빈 슬롯, 백업 광고, PubAdsService 이외의 서비스에서 렌더링된 광고 소재의 경우 값은 null입니다.

---

companyIds

• companyIds: null | number[]

• 렌더링된 백업 광고에 입찰하는 회사의 ID입니다. 빈 슬롯, 예약 광고, PubAdsService 이외의 서비스에서 렌더링된 광고 소재의 경우 값은 null입니다.

---

creativeId

• creativeId: null | number

• 렌더링된 예약 광고의 광고 소재 ID입니다. 빈 슬롯, 백업 광고, PubAdsService 이외의 서비스에서 렌더링된 광고 소재의 경우 값은 null입니다.

---

creativeTemplateId

• creativeTemplateId: null | number

• 렌더링된 예약 광고의 광고 소재 템플릿 ID입니다. 빈 슬롯, 백업 광고, PubAdsService 이외의 서비스에서 렌더링된 광고 소재의 경우 값은 null입니다.

---

isBackfill

• isBackfill: boolean

• 광고가 백업 광고인지 여부입니다. 광고가 백업 광고인 경우 값은 true, 그렇지 않은 경우 false입니다.

---

isEmpty

• isEmpty: boolean

• 슬롯에 대해 광고가 반환되었는지 여부입니다. 반환된 광고가 없으면 값은 true, 그렇지 않으면 false입니다.

---

labelIds

• labelIds: null | number[]

• 렌더링된 광고의 라벨 ID입니다. 빈 슬롯, 백업 광고, PubAdsService 이외의 서비스에서 렌더링된 광고 소재의 경우 값은 null입니다.

---

lineItemId

• lineItemId: null | number

• 렌더링된 예약 광고의 광고 항목 ID입니다. 빈 슬롯, 백업 광고, PubAdsService 이외의 서비스에서 렌더링된 광고 소재의 경우 값은 null입니다.

---

size

• size: null | string | number[]

• 렌더링된 광고 소재의 픽셀 크기를 나타냅니다. 예: [728, 90] 비어 있는 광고 슬롯의 경우 값은 null입니다.

---

slotContentChanged

• slotContentChanged: boolean

• 슬롯 콘텐츠가 렌더링된 광고로 변경되었는지 여부입니다. 콘텐츠가 변경된 경우 값은 true, 변경되지 않은 경우 false입니다.

---

sourceAgnosticCreativeId

• sourceAgnosticCreativeId: null | number

• 렌더링된 예약 또는 백업 광고의 광고 소재 ID입니다. 광고가 예약 또는 광고 항목 백업 광고가 아니거나 광고 소재가 PubAdsService 이외의 서비스에서 렌더링되는 경우 값은 null입니다.

---

sourceAgnosticLineItemId

• sourceAgnosticLineItemId: null | number

• 렌더링된 예약 또는 백업 광고의 광고 항목 ID입니다. 광고가 예약 또는 광고 항목 백업 광고가 아니거나 광고 소재가 PubAdsService 이외의 서비스에서 렌더링되는 경우 값은 null입니다.

---

yieldGroupIds

• yieldGroupIds: null | number[]

• 렌더링된 백업 광고의 수익 그룹 ID입니다. 빈 슬롯, 예약 광고, PubAdsService 이외의 서비스에서 렌더링된 광고 소재의 경우 값은 null입니다.

---

googletag.eventsSlotRequestedEvent

Event를 확장합니다.

이 이벤트는 특정 슬롯에 대해 광고가 요청되면 시작됩니다.

속성 요약
serviceName	이벤트를 트리거한 서비스의 이름입니다. googletag.events.Event.serviceName에서 상속됨
slot	이벤트를 트리거한 슬롯입니다. googletag.events.Event.slot에서 상속됨

예

JavaScript

// This listener is called when the specified service issues an ad
// request for a slot. Each slot will fire this event, even though they
// may be batched together in a single request if single request
// architecture (SRA) is enabled.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotRequested", (event) => {
  const slot = event.slot;
  console.log("Slot", slot.getSlotElementId(), "has been requested.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

자바스크립트 (기존)

// This listener is called when the specified service issues an ad
// request for a slot. Each slot will fire this event, even though they
// may be batched together in a single request if single request
// architecture (SRA) is enabled.
var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotRequested", function (event) {
  var slot = event.slot;
  console.log("Slot", slot.getSlotElementId(), "has been requested.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

TypeScript

// This listener is called when the specified service issues an ad
// request for a slot. Each slot will fire this event, even though they
// may be batched together in a single request if single request
// architecture (SRA) is enabled.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotRequested", (event) => {
  const slot = event.slot;
  console.log("Slot", slot.getSlotElementId(), "has been requested.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

참고 항목

• 광고 이벤트 리스너

---

googletag.eventsSlotResponseReceived

Event를 확장합니다.

이 이벤트는 특정 슬롯에 대한 광고 응답을 받으면 시작됩니다.

속성 요약
serviceName	이벤트를 트리거한 서비스의 이름입니다. googletag.events.Event.serviceName에서 상속됨
slot	이벤트를 트리거한 슬롯입니다. googletag.events.Event.slot에서 상속됨

예

JavaScript

// This listener is called when an ad response has been received
// for a slot.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotResponseReceived", (event) => {
  const slot = event.slot;
  console.log("Ad response for slot", slot.getSlotElementId(), "received.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

자바스크립트 (기존)

// This listener is called when an ad response has been received
// for a slot.
var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotResponseReceived", function (event) {
  var slot = event.slot;
  console.log("Ad response for slot", slot.getSlotElementId(), "received.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

TypeScript

// This listener is called when an ad response has been received
// for a slot.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotResponseReceived", (event) => {
  const slot = event.slot;
  console.log("Ad response for slot", slot.getSlotElementId(), "received.");

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

참고 항목

• 광고 이벤트 리스너

---

googletag.eventsSlotVisibilityChangedEvent

Event를 확장합니다.

이 이벤트는 광고 슬롯 영역의 화면 비율이 변경될 때마다 시작됩니다. 이벤트가 제한되며 200ms마다 한 번 이상 실행되지 않습니다.

속성 요약
inViewPercentage	표시되는 광고 영역의 비율입니다.
serviceName	이벤트를 트리거한 서비스의 이름입니다. googletag.events.Event.serviceName에서 상속됨
slot	이벤트를 트리거한 슬롯입니다. googletag.events.Event.slot에서 상속됨

예

JavaScript

// This listener is called whenever the on-screen percentage of an
// ad slot's area changes.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotVisibilityChanged", (event) => {
  const slot = event.slot;
  console.group("Visibility of slot", slot.getSlotElementId(), "changed.");

  // Log details of the event.
  console.log("Visible area:", `${event.inViewPercentage}%`);
  console.groupEnd();

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

자바스크립트 (기존)

// This listener is called whenever the on-screen percentage of an
// ad slot's area changes.
var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotVisibilityChanged", function (event) {
  var slot = event.slot;
  console.group("Visibility of slot", slot.getSlotElementId(), "changed.");

  // Log details of the event.
  console.log("Visible area:", "".concat(event.inViewPercentage, "%"));
  console.groupEnd();

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

TypeScript

// This listener is called whenever the on-screen percentage of an
// ad slot's area changes.
const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]);
googletag.pubads().addEventListener("slotVisibilityChanged", (event) => {
  const slot = event.slot;
  console.group("Visibility of slot", slot.getSlotElementId(), "changed.");

  // Log details of the event.
  console.log("Visible area:", `${event.inViewPercentage}%`);
  console.groupEnd();

  if (slot === targetSlot) {
    // Slot specific logic.
  }
});

참고 항목

• 광고 이벤트 리스너

---

inViewPercentage

• inViewPercentage: number

• 표시되는 광고 영역의 비율입니다. 값은 0~100 사이의 숫자입니다.

---

googletag.secureSignalsBidderSignalProvider

특정 입찰자에 대한 보안 신호를 반환합니다.

입찰자 보안 신호 제공업체는 다음 두 부분으로 구성됩니다.

1. 보안 신호로 확인되는 Promise를 반환하는 수집기 함수
2. id: 신호와 연결된 입찰자를 식별합니다.

게시자의 보안 신호를 반환하려면 secureSignals.PublisherSignalProvider를 대신 사용하세요.

속성 요약
collectorFunction	.
id	Google Ad Manager에 등록된 이 보안 신호와 연결된 수집기의 고유 식별자입니다.

예

JavaScript

// id is provided
googletag.secureSignalProviders.push({
  id: "collector123",
  collectorFunction: () => {
    // ...custom signal generation logic...
    return Promise.resolve("signal");
  },
});

자바스크립트 (기존)

// id is provided
googletag.secureSignalProviders.push({
  id: "collector123",
  collectorFunction: function () {
    // ...custom signal generation logic...
    return Promise.resolve("signal");
  },
});

TypeScript

// id is provided
googletag.secureSignalProviders!.push({
  id: "collector123",
  collectorFunction: () => {
    // ...custom signal generation logic...
    return Promise.resolve("signal");
  },
});

참고 항목

• 입찰자와 보안 처리된 신호 공유

---

collectorFunction

• collectorFunction: () => Promise<string>

---

id

• id: string

• Google Ad Manager에 등록된 이 보안 신호와 연결된 수집기의 고유 식별자입니다.

---

googletag.secureSignalsPublisherSignalProvider

특정 게시자의 보안 신호를 반환합니다.

게시자 신호 제공자는 다음 두 부분으로 구성됩니다.

1. 보안 신호로 확인되는 Promise를 반환하는 수집기 함수
2. 신호와 연결된 게시자를 식별하는 networkCode입니다.

입찰자에 대해 보안 신호를 반환하려면 대신 secureSignals.BidderSignalProvider를 사용하세요.

속성 요약
collectorFunction	.
networkCode	이 보안 신호와 연결된 게시자의 네트워크 코드 (광고 단위 경로에 표시됨)입니다.

예

JavaScript

// networkCode is provided
googletag.secureSignalProviders.push({
  networkCode: "123456",
  collectorFunction: () => {
    // ...custom signal generation logic...
    return Promise.resolve("signal");
  },
});

자바스크립트 (기존)

// networkCode is provided
googletag.secureSignalProviders.push({
  networkCode: "123456",
  collectorFunction: function () {
    // ...custom signal generation logic...
    return Promise.resolve("signal");
  },
});

TypeScript

// networkCode is provided
googletag.secureSignalProviders!.push({
  networkCode: "123456",
  collectorFunction: () => {
    // ...custom signal generation logic...
    return Promise.resolve("signal");
  },
});

참고 항목

• 입찰자와 보안 처리된 신호 공유

---

collectorFunction

• collectorFunction: () => Promise<string>

---

networkCode

• networkCode: string

• 이 보안 신호와 연결된 게시자의 네트워크 코드 (광고 단위 경로에 표시됨)입니다.

---

googletag.secureSignalsSecureSignalProvidersArray

보안 처리된 신호를 관리하기 위한 인터페이스입니다.

메서드 요약
clearAllCache	로컬 저장소에서 캐시된 신호를 모두 삭제합니다.
push	새 secureSignals.SecureSignalProvider를 신호 제공자 배열에 추가하고 신호 생성 프로세스를 시작합니다.

---

clearAllCache

• clearAllCache(): void

• 로컬 저장소에서 캐시된 신호를 모두 삭제합니다.

---

push

• push(provider: SecureSignalProvider): void

• 새 secureSignals.SecureSignalProvider를 신호 제공자 배열에 추가하고 신호 생성 프로세스를 시작합니다.

• 매개변수
  provider: SecureSignalProvider	배열에 추가할 secureSignals.SecureSignalProvider 객체입니다.