GPT 참조

이 참조에서는 TypeScript 표기법을 사용하여 유형을 설명합니다. 다음 표에서는 간단한 설명을 예로 들어 보겠습니다.

지원되는 유형 및 유형 표현식에 대한 자세한 내용은 다음을 참조하세요. <ph type="x-smartling-placeholder"></ph> TypeScript 핸드북 를 참고하세요.

형식 주석

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

---

유형 정의

를 탭합니다. enum 유형

---

googletag.enums.OutOfPageFormat

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

• 참고 항목

  • defineOutOfPageSlot

• 값
  BOTTOM_ANCHOR	슬롯이 표시 영역 하단에 고정되는 앵커 형식입니다.
  GAME_MANUAL_INTERSTITIAL	게임 수동 전면 광고 형식입니다. 참고: 게임 수동 전면 광고는 액세스가 제한된 형식입니다.
  INTERSTITIAL	웹 전면 광고 소재 형식입니다.
  LEFT_SIDE_RAIL	왼쪽 사이드 레일 형식
  REWARDED	보상형 광고 형식
  RIGHT_SIDE_RAIL	오른쪽 사이드 레일 형식
  TOP_ANCHOR	슬롯이 표시 영역 상단에 고정되는 앵커 형식입니다.

---

googletag.enums.TrafficSource

• GPT에서 지원하는 트래픽 소스

• 참고 항목

  • PrivacySettingsConfig.trafficSource

• 값
  ORGANIC	직접 URL 입력, 사이트 검색 또는 앱 다운로드
  PURCHASED	소유하지 않은 속성 (획득한 활동 또는 다른 방식으로 인센티브를 받은 활동)에서 리디렉션된 트래픽입니다.

---

googletag

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

---

googletag입니다.CommandArray

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

---

googletag입니다.CompanionAdsService

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

참고 항목

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

---

googletag입니다.PrivacySettingsConfig

개인 정보 보호 설정을 위한 구성 객체입니다.

참고 항목

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

---

googletag입니다.PubAdsService

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

---

googletag입니다.ResponseInformation

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

참고 항목

• Slot.getResponseInformation

---

googletag입니다.RewardedPayload

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

참고 항목

• 보상형 광고 표시

---

googletag입니다.SafeFrameConfig

SafeFrame 컨테이너의 구성 객체

참고 항목

• PubAdsService.setSafeFrameConfig

---

googletag입니다.Service

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

---

googletag입니다.SizeMappingBuilder

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

참고 항목

• 광고 크기: 반응형 광고

---

googletag입니다.Slot

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

---

를 사용해 보세요. googletag.config.AdExpansionConfig

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

예

자바스크립트

// 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 },
});

---

를 사용해 보세요. googletag.config.ComponentAuctionConfig

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

참고 항목

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

---

를 사용해 보세요. googletag.config.InterstitialConfig

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

---

를 사용해 보세요. googletag.config.PageSettingsConfig

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

한 번의 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,
    });
  

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

---

를 사용해 보세요. googletag.config.PrivacyTreatmentsConfig

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

---

를 사용해 보세요. googletag.config.PublisherProvidedSignalsConfig

게시자 제공 신호 (PPS) 구성 객체

예

자바스크립트

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

---

를 사용해 보세요. googletag.config.SlotSettingsConfig

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

단일 슬롯에 단일 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,
    });
  

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

---

를 사용해 보세요. googletag.config.TaxonomyData

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

---

를 사용해 보세요. googletag.events.Event

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

참고 항목

• 광고 이벤트 리스너

---

를 사용해 보세요. googletag.events.EventTypeMap

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

---

를 사용해 보세요. googletag.events.GameManualInterstitialSlotClosedEvent

이 이벤트는 사용자가 게임 수동 전면 광고 슬롯을 닫으면 실행됩니다.

참고: 게임 수동 전면 광고는 액세스가 제한된 형식입니다.

예

자바스크립트

// This listener is called when a game manual interstial slot is closed.
const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL
);
googletag.pubads().addEventListener("gameManualInterstitialSlotClosed", (event) => {
  const slot = event.slot;
  console.log("Game manual interstital slot", slot.getSlotElementId(), "is closed.");

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

자바스크립트 (기존)

// This listener is called when a game manual interstial slot is closed.
var targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL
);
googletag.pubads().addEventListener("gameManualInterstitialSlotClosed", function (event) {
  var slot = event.slot;
  console.log("Game manual interstital slot", slot.getSlotElementId(), "is closed.");

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

TypeScript

// This listener is called when a game manual interstial slot is closed.
const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL
);
googletag.pubads().addEventListener("gameManualInterstitialSlotClosed", (event) => {
  const slot = event.slot;
  console.log("Game manual interstital slot", slot.getSlotElementId(), "is closed.");

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

참고 항목

• 광고 이벤트 리스너
• 게임 수동 전면 광고 표시

---

를 사용해 보세요. googletag.events.GameManualInterstitialSlotReadyEvent

이 이벤트는 게임 수동 전면 광고 슬롯이 사용자에게 표시될 준비가 되면 실행됩니다.

참고: 게임 수동 전면 광고는 액세스가 제한된 형식입니다.

예

자바스크립트

// This listener is called when a game manual interstitial slot is ready to
// be displayed.
const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL
);
googletag.pubads().addEventListener("gameManualInterstitialSlotReady", (event) => {
  const slot = event.slot;
  console.log("Game manual interstital slot", slot.getSlotElementId(), "is ready to be displayed.");

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

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

자바스크립트 (기존)

// This listener is called when a game manual interstitial slot is ready to
// be displayed.
var targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL
);
googletag.pubads().addEventListener("gameManualInterstitialSlotReady", function (event) {
  var slot = event.slot;
  console.log("Game manual interstital slot", slot.getSlotElementId(), "is ready to be displayed.");

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

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

TypeScript

// This listener is called when a game manual interstitial slot is ready to
// be displayed.
const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL
);
googletag.pubads().addEventListener("gameManualInterstitialSlotReady", (event) => {
  const slot = event.slot;
  console.log("Game manual interstital slot", slot.getSlotElementId(), "is ready to be displayed.");

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

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

참고 항목

• 광고 이벤트 리스너
• 게임 수동 전면 광고 표시

---

를 사용해 보세요. googletag.events.ImpressionViewableEvent

이 이벤트는 노출이 Active View 기준에 따라 조회 가능 상태가 되면 실행됩니다.

예

자바스크립트

// 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.events.RewardedSlotClosedEvent

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

예

자바스크립트

// 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.events.RewardedSlotGrantedEvent

이 이벤트는 보상형 광고를 본 대가로 리워드가 부여되면 실행됩니다. 리워드 부여 기준이 충족되기 전에 광고가 닫히면 이벤트가 실행되지 않습니다.

예

자바스크립트

// 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.
  }
});

참고 항목

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

---

를 사용해 보세요. googletag.events.RewardedSlotReadyEvent

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

예

자바스크립트

// 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.
  }
});

참고 항목

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

---

를 사용해 보세요. googletag.events.SlotOnloadEvent

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

예

자바스크립트

// 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.events.SlotRenderEndedEvent

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

예

자바스크립트

// 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.
  }
});

참고 항목

• 광고 이벤트 리스너

---

를 사용해 보세요. googletag.events.SlotRequestedEvent

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

예

자바스크립트

// 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.events.SlotResponseReceived

이 이벤트는 특정 슬롯에 대한 광고 응답이 수신되면 시작됩니다.

예

자바스크립트

// 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.events.SlotVisibilityChangedEvent

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

예

자바스크립트

// 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.
  }
});

참고 항목

• 광고 이벤트 리스너

---

를 사용해 보세요. googletag.secureSignals.BidderSignalProvider

특정 입찰자에 대해 보안 처리된 신호를 반환합니다.

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

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

예

자바스크립트

// 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");
  },
});

참고 항목

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

---

를 사용해 보세요. googletag.secureSignals.PublisherSignalProvider

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

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

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

예

자바스크립트

// 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");
  },
});

참고 항목

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

---

를 사용해 보세요. googletag.secureSignals.SecureSignalProvidersArray

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