Referensi GPT

Referensi ini menggunakan notasi TypeScript untuk menjelaskan jenis. Tabel berikut memberikan penjelasan singkat melalui contoh.

Untuk mempelajari lebih lanjut jenis dan ekspresi jenis yang didukung, lihat Panduan TypeScript .

Anotasi Type

Titik dua setelah variabel, nama parameter, nama properti, atau tanda tangan fungsi menunjukkan jenis anotasi. Anotasi jenis menjelaskan jenis elemen di sebelah kiri tanda titik dua dapat diterima atau dikembalikan. Tabel berikut menunjukkan contoh anotasi jenis yang mungkin Anda lihat di pada referensi ini.

---

Definisi Jenis

Jenis Enum

---

googletag.enums.OutOfPageFormat

• Format di luar halaman yang didukung oleh GPT.

• Lihat juga

  • defineOutOfPageSlot

• Nilai
  BOTTOM_ANCHOR	Format anchor dengan slot menempel di bagian bawah area tampilan.
  GAME_MANUAL_INTERSTITIAL	Format interstisial manual game. Catatan: Interstisial manual game adalah format akses terbatas.
  INTERSTITIAL	Format materi iklan interstisial web.
  LEFT_SIDE_RAIL	Format kolom samping kiri.
  REWARDED	Format reward.
  RIGHT_SIDE_RAIL	Format kolom samping kanan.
  TOP_ANCHOR	Format anchor dengan slot menempel di bagian atas area pandang.

---

googletag.enums.TrafficSource

• Sumber traffic yang didukung oleh GPT.

• Lihat juga

  • PrivacySettingsConfig.trafficSource

• Nilai
  ORGANIC	Entri URL langsung, penelusuran situs, atau download aplikasi.
  PURCHASED	Traffic yang dialihkan dari properti selain yang dimiliki (aktivitas yang diperoleh atau diberi insentif).

---

googletag

Namespace global yang digunakan Tag Google Publisher untuk API-nya.

---

googletag.CommandArray

Array perintah menerima urutan fungsi dan memanggilnya secara berurutan. Hal ini dimaksudkan untuk menggantikan array standar yang digunakan untuk mengantrekan fungsi yang akan dipanggil setelah GPT dimuat.

---

googletag.CompanionAdsService

Layanan Iklan Pengiring. Layanan ini digunakan oleh iklan video untuk menampilkan iklan pengiring.

Lihat juga

• Iklan pengiring untuk video dan audio

---

googletag.PrivacySettingsConfig

Objek konfigurasi untuk setelan privasi.

Lihat juga

• Mengonfigurasi setelan privasi

---

googletag.PubAdsService

Layanan Iklan Penayang. Layanan ini digunakan untuk mengambil dan menampilkan iklan dari akun Google Ad Manager Anda.

---

googletag.ResponseInformation

Objek yang mewakili satu respons iklan.

Lihat juga

• Slot.getResponseInformation

---

googletag.RewardedPayload

Objek yang mewakili reward yang terkait dengan iklan reward

Lihat juga

• Menampilkan iklan reward

---

googletag.SafeFrameConfig

Objek konfigurasi untuk penampung SafeFrame.

Lihat juga

• PubAdsService.setSafeFrameConfig

---

googletag.Service

Class layanan dasar yang berisi metode yang umum untuk semua layanan.

---

googletag.SizeMappingBuilder

Builder untuk objek spesifikasi pemetaan ukuran. Builder ini disediakan untuk membantu menyusun spesifikasi ukuran dengan mudah.

Lihat juga

• Ukuran iklan: Iklan responsif

---

googletag.Slot

Slot adalah objek yang mewakili satu slot iklan pada halaman.

---

googletag.config.AdExpansionConfig

Setelan untuk mengontrol perluasan iklan.

Contoh

JavaScript

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

JavaScript (lama)

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

Objek yang mewakili lelang komponen tunggal dalam lelang iklan di perangkat.

Lihat juga

• Panduan Penjual Protected Audience API: menjalankan lelang iklan

---

googletag.config.InterstitialConfig

Objek yang menentukan perilaku satu slot iklan interstisial.

---

googletag.config.PageSettingsConfig

Antarmuka konfigurasi utama untuk setelan tingkat halaman.

Memungkinkan penetapan beberapa fitur dengan satu panggilan API.

Semua properti yang tercantum di bawah adalah contoh dan tidak mencerminkan fitur sebenarnya yang menggunakan setConfig. Untuk mengetahui kumpulan fitur, lihat kolom dalam jenis PageSettingsConfig di bawah.

Contoh:

• Hanya fitur yang ditetapkan dalam panggilan setConfig yang diubah.

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

• Semua setelan untuk fitur tertentu diperbarui dengan setiap panggilan ke 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
        }
    });
  

• Semua setelan fitur dapat dihapus dengan meneruskan 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

Setelan untuk mengontrol perlakuan privasi penayang.

---

googletag.config.PublisherProvidedSignalsConfig

Objek konfigurasi sinyal yang diberikan penayang (PPS).

Contoh

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

JavaScript (lama)

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

Lihat juga

• Tentang sinyal yang diberikan penayang (Beta)
• Taksonomi Audiens IAB 1.1
• Taksonomi Konten IAB 2.2

---

googletag.config.SlotSettingsConfig

Antarmuka konfigurasi utama untuk setelan tingkat slot.

Memungkinkan penetapan beberapa fitur dengan satu panggilan API untuk satu slot.

Semua properti yang tercantum di bawah adalah contoh dan tidak mencerminkan fitur sebenarnya yang menggunakan setConfig. Untuk mengetahui kumpulan fitur, lihat kolom dalam jenis SlotSettingsConfig di bawah.

Contoh:

• Hanya fitur yang ditetapkan dalam panggilan Slot.setConfig yang diubah.

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

• Semua setelan untuk fitur tertentu diperbarui dengan setiap panggilan ke 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
        }
    });
  

• Semua setelan fitur dapat dihapus dengan meneruskan 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

Objek yang berisi nilai untuk satu Taksonomi.

---

googletag.events.Event

Antarmuka Dasar untuk semua peristiwa GPT. Semua peristiwa GPT di bawah akan memiliki kolom berikut.

Lihat juga

• Pemroses peristiwa iklan

---

googletag.events.EventTypeMap

Ini adalah jenis semu yang memetakan nama peristiwa ke jenis objek peristiwa yang sesuai untuk Service.addEventListener dan Service.removeEventListener. Hal ini didokumentasikan hanya untuk tujuan referensi dan jenis keamanan.

---

googletag.events.GameManualInterstitialSlotClosedEvent

Peristiwa ini diaktifkan saat slot interstisial manual game telah ditutup oleh pengguna.

Catatan: Interstisial manual game adalah format akses terbatas.

Contoh

JavaScript

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

JavaScript (lama)

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

Lihat juga

• Pemroses peristiwa iklan
• Menampilkan iklan interstisial manual game

---

googletag.events.GameManualInterstitialSlotReadyEvent

Peristiwa ini diaktifkan saat slot interstisial manual game siap ditampilkan kepada pengguna.

Catatan: Interstisial manual game adalah format akses terbatas.

Contoh

JavaScript

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

JavaScript (lama)

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

Lihat juga

• Pemroses peristiwa iklan
• Menampilkan iklan interstisial manual game

---

googletag.events.ImpressionViewableEvent

Peristiwa ini diaktifkan saat tayangan iklan terlihat, sesuai dengan kriteria Tampilan Aktif.

Contoh

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

JavaScript (lama)

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

Lihat juga

• Pemroses peristiwa iklan

---

googletag.events.RewardedSlotClosedEvent

Peristiwa ini diaktifkan saat slot iklan reward ditutup oleh pengguna. Reward dapat diaktifkan sebelum atau setelah reward diberikan. Untuk menentukan apakah reward telah diberikan, gunakan events.RewardedSlotGrantedEvent.

Contoh

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

JavaScript (lama)

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

Lihat juga

• Pemroses peristiwa iklan
• Menampilkan iklan reward

---

googletag.events.RewardedSlotGrantedEvent

Peristiwa ini diaktifkan saat reward diberikan karena melihat iklan reward. Jika iklan ditutup sebelum kriteria pemberian reward terpenuhi, peristiwa ini tidak akan diaktifkan.

Contoh

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

JavaScript (lama)

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

Lihat juga

• Pemroses peristiwa iklan
• Menampilkan iklan reward

---

googletag.events.RewardedSlotReadyEvent

Peristiwa ini diaktifkan saat iklan reward siap ditampilkan. Penayang bertanggung jawab untuk memberikan opsi kepada pengguna untuk melihat iklan sebelum menampilkannya.

Contoh

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

JavaScript (lama)

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

Lihat juga

• Pemroses peristiwa iklan
• Menampilkan iklan reward

---

googletag.events.SlotOnloadEvent

Peristiwa ini diaktifkan saat iframe materi iklan mengaktifkan peristiwa pemuatannya. Saat merender iklan multimedia dalam mode rendering sinkronisasi, tidak ada iframe yang digunakan sehingga tidak ada SlotOnloadEvent yang akan diaktifkan.

Contoh

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

JavaScript (lama)

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

Lihat juga

• Pemroses peristiwa iklan

---

googletag.events.SlotRenderEndedEvent

Peristiwa ini diaktifkan saat kode materi iklan dimasukkan ke dalam slot. Peristiwa ini akan terjadi sebelum resource materi iklan diambil, sehingga materi iklan mungkin belum terlihat. Jika Anda perlu mengetahui kapan semua resource materi iklan untuk slot telah selesai dimuat, pertimbangkan events.SlotOnloadEvent.

Contoh

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

JavaScript (lama)

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

Lihat juga

• Pemroses peristiwa iklan

---

googletag.events.SlotRequestedEvent

Peristiwa ini diaktifkan saat iklan telah diminta untuk slot tertentu.

Contoh

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

JavaScript (lama)

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

Lihat juga

• Pemroses peristiwa iklan

---

googletag.events.SlotResponseReceived

Peristiwa ini diaktifkan saat respons iklan telah diterima untuk slot tertentu.

Contoh

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

JavaScript (lama)

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

Lihat juga

• Pemroses peristiwa iklan

---

googletag.events.SlotVisibilityChangedEvent

Peristiwa ini diaktifkan setiap kali persentase area slot iklan di layar berubah. Peristiwa ini dibatasi dan tidak akan diaktifkan lebih dari sekali setiap 200 md.

Contoh

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

JavaScript (lama)

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

Lihat juga

• Pemroses peristiwa iklan

---

googletag.secureSignals.BidderSignalProvider

Menampilkan sinyal aman untuk bidder tertentu.

Penyedia sinyal aman bidder terdiri dari 2 bagian:

1. Fungsi kolektor, yang menampilkan Promise yang di-resolve menjadi sinyal aman.
2. id yang mengidentifikasi bidder yang terkait dengan sinyal.

Contoh

JavaScript

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

JavaScript (lama)

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

Lihat juga

• Membagikan sinyal aman kepada bidder

---

googletag.secureSignals.PublisherSignalProvider

Menampilkan sinyal aman untuk penayang tertentu.

Penyedia sinyal penayang terdiri dari 2 bagian:

1. Fungsi kolektor, yang menampilkan Promise yang di-resolve menjadi sinyal aman.
2. networkCode yang mengidentifikasi penayang yang terkait dengan sinyal.

Contoh

JavaScript

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

JavaScript (lama)

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

Lihat juga

• Membagikan sinyal aman kepada bidder

---

googletag.secureSignals.SecureSignalProvidersArray

Antarmuka untuk mengelola sinyal aman.