GPT 참조

인수에 지정된 함수 시퀀스를 순서대로 실행합니다.

예

자바스크립트

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());
});

채워지지 않은 컴패니언 광고가 자동으로 백업되는지 여부를 설정합니다.

이 메서드는 페이지의 전체 기간 동안 여러 번 호출하여 백필을 사용 설정 또는 중지할 수 있습니다. PubAdsService에 등록된 슬롯만 백필됩니다. 정책 제한으로 인해 이 메서드는 Ad Exchange 동영상이 게재될 때 빈 컴패니언 슬롯을 채우도록 설계되지 않았습니다.

예

자바스크립트

googletag.companionAds().setRefreshUnfilledSlots(true);

자바스크립트 (기존)

googletag.companionAds().setRefreshUnfilledSlots(true);

TypeScript

googletag.companionAds().setRefreshUnfilledSlots(true);

페이지를 아동용으로 취급해야 하는지 여부를 나타냅니다. 구성을 지우려면 null로 설정합니다.

게시자 규정 준수 요구사항을 충족하기 위해 제한적인 광고 모드에서 게재를 실행할 수 있습니다.

GPT에 제한적인 광고를 요청하도록 지시하는 방법은 두 가지가 있습니다.

• IAB TCF v2.0 동의 관리 플랫폼의 신호를 사용하여 자동으로
• 이 필드의 값을 true로 설정하여 수동으로

예

자바스크립트

// Manually enable limited ads serving.
// GPT must be loaded from the limited ads URL to configure this setting.
googletag.pubads().setPrivacySettings({
  limitedAds: true,
});

자바스크립트 (기존)

// Manually enable limited ads serving.
// GPT must be loaded from the limited ads URL to configure this setting.
googletag.pubads().setPrivacySettings({
  limitedAds: true,
});

TypeScript

// Manually enable limited ads serving.
// GPT must be loaded from the limited ads URL to configure this setting.
googletag.pubads().setPrivacySettings({
  limitedAds: true,
});

참고 항목

• 제한적인 광고 게재

게시자 규정 준수 요구사항을 지원하기 위해 개인 맞춤이 아닌 광고 모드에서 게재를 실행할 수 있도록 합니다.

게시자 규정 준수 요구사항을 지원하기 위해 게재가 제한된 처리 모드로 실행되도록 합니다.

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

예

자바스크립트

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

광고 요청이 동의 연령 미만 사용자로부터 발생한 것으로 표시할지 여부를 나타냅니다. 구성을 지우려면 null로 설정합니다.

지정된 슬롯에서 광고를 삭제하고 빈 콘텐츠로 대체합니다. 슬롯은 가져오지 않은 것으로 표시됩니다.

특히 슬롯을 삭제하면 GPT의 오래 지속되는 페이지 조회에서 광고가 삭제되므로, 향후 요청이 이 광고와 관련된 로드블록이나 경쟁 제외의 영향을 받지 않습니다.

예

자바스크립트

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();

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

예

자바스크립트

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

참고 항목

• 광고 차단을 위한 맞춤 라벨

특정 키 또는 모든 키의 맞춤 타겟팅 매개변수를 삭제합니다.

예

자바스크립트

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.

참고 항목

• 키-값 타겟팅

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

참고 항목

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

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

참고 항목

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

지정된 광고 단위 경로와 크기를 가진 광고 슬롯을 만들어 표시합니다. 이 메서드는 단일 요청 모드에서 작동하지 않습니다.

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

예

자바스크립트

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");

참고 항목

• 테스트 광고 표시
• 광고 로드 및 새로고침 제어

구성 객체에 의해 정의된 대로 GPT에서 지연 로드를 사용 설정합니다. 자세한 예는 지연 로드 샘플을 참고하세요.

참고: SRA의 지연 가져오기는 모든 슬롯이 가져오기 여백을 벗어나는 경우에만 작동합니다.

예

자바스크립트

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

참고 항목

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

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

참고 항목

• 광고 권장사항: 단일 요청 아키텍처 올바르게 사용하기
• SRA 일괄 처리 제어

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

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

예

자바스크립트

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'.

참고 항목

• 애드센스 속성

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

예

자바스크립트

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'].

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

예

자바스크립트

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).

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

예

자바스크립트

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'].

광고의 초기 요청이 이전 PubAdsService.disableInitialLoad 호출로 성공적으로 중지되었는지 여부를 반환합니다.

페이지의 특정 또는 모든 슬롯에 대한 새 광고를 가져와 표시합니다. 비동기 렌더링 모드에서만 작동합니다.

모든 브라우저에서 올바르게 작동하려면 refresh를 호출하기 전에 광고 슬롯 display를 호출해야 합니다. display 호출을 생략하면 새로고침이 예기치 않게 작동할 수 있습니다. 원하는 경우 PubAdsService.disableInitialLoad 메서드를 사용하여 display에서 광고를 가져오지 못하도록 할 수 있습니다.

슬롯을 새로고침하면 GPT의 오래 지속되는 페이지 조회에서 이전 광고가 삭제되므로 향후 요청이 해당 광고와 관련된 로드블록이나 경쟁 제외의 영향을 받지 않습니다.

예

자바스크립트

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

참고 항목

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

게시자 광고 서비스의 모든 광고 슬롯에 적용되는 애드센스 속성의 값을 설정합니다.

동일한 키에 대해 이 함수를 두 번 이상 호출하면 해당 키에 대해 이전에 설정된 값이 재정의됩니다. display 또는 refresh를 호출하기 전에 모든 값을 설정해야 합니다.

예

자바스크립트

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

자바스크립트 (기존)

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

TypeScript

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

참고 항목

• 애드센스 속성

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

예

자바스크립트

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

자바스크립트 (기존)

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

TypeScript

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

참고 항목

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

광고의 가로 중앙 정렬을 사용 설정하거나 중지합니다. 중앙 정렬은 기본적으로 사용 중지되어 있습니다. 기존 gpt_mobile.js에서는 중앙 정렬이 기본적으로 사용 설정됩니다.

이 메서드를 호출한 후에 요청된 광고만 중앙에 정렬되므로 이 메서드는 display 또는 refresh를 호출하기 전에 호출해야 합니다.

예

자바스크립트

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

자바스크립트 (기존)

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

TypeScript

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

페이지의 모든 광고를 SafeFrame 컨테이너를 사용하여 강제로 렌더링해야 하는지 구성합니다.

이 API를 사용할 때는 다음 사항에 유의하세요.

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

예

자바스크립트

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을 사용하여 광고 소재 렌더링하기

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

예

자바스크립트

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

자바스크립트 (기존)

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

TypeScript

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

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

예

자바스크립트

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

참고 항목

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

게시자가 제공하는 ID의 값을 설정합니다.

예

자바스크립트

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

자바스크립트 (기존)

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

TypeScript

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

참고 항목

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

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

이러한 페이지 수준 환경설정은 지정된 경우 슬롯 수준 환경설정으로 재정의됩니다.

예

자바스크립트

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을 사용하여 광고 소재 렌더링하기

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

예

자바스크립트

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

참고 항목

• 키-값 타겟팅

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

참고 항목

• VAST 광고 태그 URL 매개변수

광고 요청과 함께 전송되는 상관자를 변경하여 새 페이지 조회를 시작합니다. 상관자는 하나의 페이지 조회에서 발생하는 모든 광고 요청에 대해 동일하며 페이지 조회마다 고유합니다. 비동기 모드에만 적용됩니다.

참고: 이는 페이지에 실제로 광고를 자동으로 반영하며 만료 시간이 없는 GPT의 오래 지속되는 페이지 조회에는 영향을 미치지 않습니다.

예

자바스크립트

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

광고주의 ID입니다.

캠페인의 ID입니다.

광고 소재의 ID입니다.

광고의 템플릿 ID입니다.

광고 항목의 ID입니다.

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

보상에 포함된 항목 유형입니다 (예: 'coin').

SafeFrame에서 페이지 콘텐츠를 오버레이하여 광고 콘텐츠를 확장할 수 있는지 여부입니다.

SafeFrame에서 페이지 콘텐츠를 푸시하여 광고 콘텐츠를 확장하도록 허용할지 여부입니다.

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

SafeFrame에서 예약 광고 소재에 임의 하위 도메인을 사용해야 하는지 여부입니다. null를 전달하여 저장된 값을 지웁니다.

참고: 이 기능은 기본적으로 사용 설정되어 있습니다.

참고 항목

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

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

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

예

자바스크립트

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

참고 항목

• 광고 이벤트 리스너

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