Referensi GPT

Referensi ini menggunakan notasi TypeScript untuk mendeskripsikan jenis. Tabel berikut memberikan penjelasan singkat berdasarkan contoh.

Ekspresi jenis
string	Jenis string primitif.
string[]	Jenis array, dengan nilai yang hanya boleh berupa string.
number | string	Jenis gabungan, dengan nilai yang dapat berupa angka atau string.
Array<number | string>	Jenis array, dengan nilai berupa jenis kompleks (gabungan).
[number, string]	Jenis tuple, dengan nilai berupa array dua elemen yang harus berisi angka dan string dalam urutan tersebut.
Slot	Jenis objek, dengan nilai yang merupakan instance dari googletag.Slot.
() => void	Jenis fungsi tanpa argumen yang ditentukan dan tanpa nilai yang ditampilkan.

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

Anotasi Type

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

Anotasi jenis
param: string	Menunjukkan bahwa param menerima atau menampilkan nilai string. Sintaksis ini digunakan untuk variabel, parameter, properti, dan jenis nilai yang ditampilkan.
param?: number | string	Menunjukkan bahwa param bersifat opsional, tetapi menerima angka atau string jika ditentukan. Sintaksis ini digunakan untuk parameter dan properti.
...params: Array<() => void>	Menunjukkan bahwa params adalah parameter rest yang menerima fungsi. Parameter rest menerima jumlah nilai yang tidak terbatas dari jenis yang ditentukan.

---

googletag

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

Namespace
config	Antarmuka konfigurasi utama untuk setelan tingkat halaman.
enums	Ini adalah namespace yang digunakan GPT untuk jenis enum.
events	Ini adalah namespace yang digunakan GPT untuk Peristiwa.
secureSignals	Ini adalah namespace yang digunakan GPT untuk mengelola sinyal aman.

Antarmuka
CommandArray	Array perintah menerima urutan fungsi dan memanggilnya secara berurutan.
CompanionAdsService	Layanan Iklan Pengiring.
PrivacySettingsConfig	Objek konfigurasi untuk setelan privasi.
PubAdsService	Layanan Iklan Penayang.
RequestHook	Fungsi callback yang dipanggil sebelum setiap panggilan iklan saat didaftarkan melalui PubAdsService.registerRequestHook.
ResponseInformation	Objek yang mewakili satu respons iklan.
RewardedPayload	Objek yang mewakili reward yang terkait dengan iklan reward.
Service	Class layanan dasar yang berisi metode umum untuk semua layanan.
SizeMappingBuilder	Builder untuk objek spesifikasi pemetaan ukuran.
Slot	Slot adalah objek yang mewakili satu slot iklan di halaman.

Alias Jenis
FluidSize	String ukuran tempat penampung iklan mengambil 100% lebar div induknya, lalu mengubah tinggi agar sesuai dengan konten materi iklan.
GeneralSize	Konfigurasi ukuran yang valid untuk slot, yang dapat berupa satu atau beberapa ukuran.
MultiSize	Daftar ukuran tunggal yang valid.
NamedSize	Ukuran bernama yang dapat dimiliki slot.
SingleSize	Satu ukuran yang valid untuk slot.
SingleSizeArray	Array dua angka yang mewakili [lebar, tinggi].
SizeMapping	Pemetaan ukuran area pandang ke ukuran iklan.
SizeMappingArray	Daftar pemetaan ukuran.

Variabel
apiReady	Flag yang menunjukkan bahwa GPT API dimuat dan siap dipanggil.
cmd	Referensi ke antrean perintah global untuk eksekusi asinkron panggilan terkait GPT.
pubadsReady	Tanda yang menunjukkan bahwa PubAdsService diaktifkan, dimuat, dan beroperasi sepenuhnya.
secureSignalProviders	Referensi ke array penyedia sinyal aman.

Fungsi
companionAds	Menampilkan referensi ke CompanionAdsService.
defineOutOfPageSlot	Membuat slot iklan di luar halaman dengan jalur unit iklan yang diberikan.
defineSlot	Membuat slot iklan dengan jalur dan ukuran unit iklan tertentu, serta mengaitkannya dengan ID elemen div di halaman yang akan berisi iklan.
destroySlots	Menghancurkan slot yang ditentukan, menghapus semua objek dan referensi terkait dari slot tersebut dari GPT.
disablePublisherConsole	Menonaktifkan Konsol Penayang Google.
display	Menginstruksikan layanan slot untuk merender slot.
enableServices	Mengaktifkan semua layanan GPT yang telah ditentukan untuk slot iklan di halaman.
getConfig	Mendapatkan salinan beku dari opsi konfigurasi umum untuk halaman yang ditetapkan oleh setConfig.
getVersion	Menampilkan versi GPT saat ini.
openConsole	Membuka Konsol Penayang Google.
pubads	Menampilkan referensi ke PubAdsService.
setAdIframeTitle	Menetapkan judul untuk semua iframe penampung iklan yang dibuat oleh PubAdsService, mulai dari titik ini dan seterusnya.
setConfig	Menetapkan opsi konfigurasi umum untuk halaman.
sizeMapping	Membuat SizeMappingBuilder baru.

Alias Jenis

---

FluidSize

FluidSize: "fluid"

String ukuran tempat penampung iklan mengambil 100% lebar div induknya, lalu mengubah tinggi agar sesuai dengan konten materi iklan. Mirip dengan perilaku elemen blok reguler di halaman. Digunakan untuk iklan native dan banner (lihat artikel terkait).

---

GeneralSize

GeneralSize: SingleSize | MultiSize

Konfigurasi ukuran yang valid untuk slot, yang dapat berupa satu atau beberapa ukuran.

---

MultiSize

MultiSize: SingleSize[]

Daftar ukuran tunggal yang valid.

---

NamedSize

NamedSize: FluidSize | [FluidSize]

Ukuran bernama yang dapat dimiliki slot. Dalam sebagian besar kasus, ukuran adalah persegi panjang berukuran tetap, tetapi ada beberapa kasus saat kita memerlukan jenis spesifikasi ukuran lainnya. Hanya ukuran bernama berikut yang valid:

• fluid: penampung iklan menggunakan 100% lebar div induknya, lalu mengubah ukurannya agar sesuai dengan konten materi iklan. Mirip dengan perilaku elemen blok reguler di halaman. Digunakan untuk iklan native dan banner (lihat artikel terkait). Perhatikan bahwa fluid dan ['fluid'] adalah bentuk yang dapat diterima untuk mendeklarasikan ukuran slot sebagai fluid.

---

SingleSize

SingleSize: SingleSizeArray | NamedSize

Satu ukuran yang valid untuk slot.

---

SingleSizeArray

SingleSizeArray: [number, number]

Array dua angka yang mewakili [lebar, tinggi].

---

SizeMapping

SizeMapping: [SingleSizeArray, GeneralSize]

Pemetaan ukuran area pandang ke ukuran iklan. Digunakan untuk iklan responsif.

---

SizeMappingArray

SizeMappingArray: SizeMapping[]

Daftar pemetaan ukuran.

Variabel

---

Const apiReady

apiReady: boolean | undefined

Flag yang menunjukkan bahwa GPT API dimuat dan siap dipanggil. Properti ini hanya akan menjadi undefined hingga API siap.

Perhatikan bahwa cara yang direkomendasikan untuk menangani asinkron adalah menggunakan googletag.cmd untuk mengantrekan callback saat GPT siap. Callback ini tidak harus memeriksa googletag.apiReady karena dijamin akan dijalankan setelah API disiapkan.

---

Const cmd

cmd: ((this: typeof globalThis) => void)[] | CommandArray

Referensi ke antrean perintah global untuk eksekusi asinkron panggilan terkait GPT.

Variabel googletag.cmd diinisialisasi ke array JavaScript kosong oleh sintaksis tag GPT di halaman, dan cmd.push adalah metode Array.push standar yang menambahkan elemen ke akhir array. Saat JavaScript GPT dimuat, JavaScript akan memeriksa array dan menjalankan semua fungsi secara berurutan. Skrip kemudian mengganti cmd dengan objek CommandArray yang metode push-nya ditentukan untuk menjalankan argumen fungsi yang diteruskan ke objek tersebut. Mekanisme ini memungkinkan GPT mengurangi latensi yang dirasakan dengan mengambil JavaScript secara asinkron sekaligus memungkinkan browser terus merender halaman.

Contoh

JavaScript

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

JavaScript (lama)

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

---

Const pubadsReady

pubadsReady: boolean | undefined

Tanda yang menunjukkan bahwa PubAdsService diaktifkan, dimuat, dan beroperasi sepenuhnya. Properti ini hanya akan menjadi undefined hingga enableServices dipanggil dan PubAdsService dimuat dan diinisialisasi.

---

secureSignalProviders

secureSignalProviders: SecureSignalProvider[] | SecureSignalProvidersArray | undefined

Referensi ke array penyedia sinyal aman.

Array penyedia sinyal aman menerima urutan fungsi penghasil sinyal dan memanggilnya secara berurutan. Fungsi ini dimaksudkan untuk menggantikan array standar yang digunakan untuk mengantrekan fungsi penghasil sinyal yang akan dipanggil setelah GPT dimuat.

Contoh

JavaScript

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

JavaScript (lama)

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

Lihat juga

• Membagikan sinyal aman kepada bidder

Fungsi

---

companionAds

companionAds(): CompanionAdsService

Menampilkan referensi ke CompanionAdsService.

Hasil
CompanionAdsService	Layanan Iklan Pengiring.

---

defineOutOfPageSlot

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

Membuat slot iklan di luar halaman dengan jalur unit iklan yang diberikan.

Untuk iklan kustom di luar halaman, div adalah ID elemen div yang akan berisi iklan. Lihat artikel tentang materi iklan di luar halaman untuk mengetahui detail selengkapnya.

Untuk iklan di luar halaman yang dikelola GPT, div adalah OutOfPageFormat yang didukung.

Contoh

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

JavaScript (lama)

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

Lihat juga

• Menampilkan iklan reward
• Menampilkan iklan interstisial web
• Menampilkan iklan anchor
• Menampilkan iklan di luar halaman

Parameter
adUnitPath: string	Jalur unit iklan lengkap dengan kode jaringan dan kode unit iklan.
Optional div: string | OutOfPageFormat	ID div yang akan berisi unit iklan atau OutOfPageFormat ini.

Hasil
Slot | null	Slot yang baru dibuat, atau null jika slot tidak dapat dibuat.

---

defineSlot

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

Membuat slot iklan dengan jalur dan ukuran unit iklan tertentu, serta mengaitkannya dengan ID elemen div di halaman yang akan berisi iklan.

Contoh

JavaScript

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

JavaScript (lama)

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

TypeScript

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

Lihat juga

• Mulai Menggunakan Tag Penayang Google

Parameter
adUnitPath: string	Jalur unit iklan lengkap dengan kode jaringan dan kode unit.
size: GeneralSize	Lebar dan tinggi slot yang ditambahkan. Ukuran ini digunakan dalam panggilan iklan jika tidak ada pemetaan ukuran responsif yang diberikan atau ukuran area tampilan lebih kecil daripada ukuran terkecil yang diberikan dalam pemetaan.
Optional div: string	ID div yang akan berisi unit iklan ini.

Hasil
Slot | null	Slot yang baru dibuat, atau null jika slot tidak dapat dibuat.

---

destroySlots

destroySlots(slots?: Slot[]): boolean

Menghancurkan slot yang ditentukan, menghapus semua objek dan referensi terkait dari slot tersebut dari GPT. API ini tidak mendukung slot pengembalian dan slot pengiring.

Memanggil API ini pada slot akan menghapus iklan dan menghapus objek slot dari status internal yang dikelola oleh GPT. Memanggil fungsi lainnya pada objek slot akan menghasilkan perilaku yang tidak ditentukan. Perhatikan bahwa browser mungkin masih tidak mengosongkan memori yang terkait dengan slot tersebut jika referensi ke slot tersebut dipertahankan oleh halaman penayang. Memanggil API ini akan membuat div yang terkait dengan slot tersebut tersedia untuk digunakan kembali.

Secara khusus, menghancurkan slot akan menghapus iklan dari tayangan halaman yang berjalan lama GPT, sehingga permintaan mendatang tidak akan dipengaruhi oleh roadblock atau pengecualian kompetitif yang melibatkan iklan ini. Jika fungsi ini tidak dipanggil sebelum menghapus div slot dari halaman, perilaku yang tidak ditentukan akan terjadi.

Contoh

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

JavaScript (lama)

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

Parameter
Optional slots: Slot[]	Array slot yang akan dihancurkan. Array bersifat opsional; semua slot akan dihancurkan jika tidak ditentukan.

Hasil
boolean	true jika slot telah dihancurkan, false jika tidak.

---

disablePublisherConsole

disablePublisherConsole(): void

Menonaktifkan Konsol Penayang Google.

Lihat juga

• Konsol Penayang Google

---

layar

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

Menginstruksikan layanan slot untuk merender slot. Setiap slot iklan hanya boleh ditampilkan sekali per halaman. Semua slot harus ditentukan dan memiliki layanan yang terkait dengannya sebelum ditampilkan. Panggilan tampilan tidak boleh terjadi hingga elemen ada di DOM. Cara yang biasa dilakukan untuk mencapainya adalah dengan menempatkannya dalam blok skrip dalam elemen div yang disebutkan dalam panggilan metode.

Jika arsitektur permintaan tunggal (SRA) digunakan, semua slot iklan yang belum diambil pada saat metode ini dipanggil akan diambil sekaligus. Untuk memaksa slot iklan agar tidak ditampilkan, seluruh div harus dihapus.

Lihat juga

• Mulai Menggunakan Tag Penayang Google
• Menampilkan iklan pengujian
• Mengontrol pemuatan dan pemuatan ulang iklan

Parameter
divOrSlot: string | Element | Slot	ID elemen div yang berisi slot iklan atau elemen div, atau objek slot. Jika elemen div diberikan, elemen tersebut harus memiliki atribut 'id' yang cocok dengan ID yang diteruskan ke defineSlot.

---

enableServices

enableServices(): void

Mengaktifkan semua layanan GPT yang telah ditentukan untuk slot iklan di halaman.

---

getConfig

getConfig(keys: string | string[]): Readonly<Pick<PageSettingsConfig, "adsenseAttributes" | "disableInitialLoad" | "targeting">>

Mendapatkan salinan beku opsi konfigurasi umum untuk halaman yang ditetapkan oleh setConfig.

Tidak semua properti setConfig() didukung oleh metode ini. Properti yang didukung adalah:

• adsenseAttributes
• disableInitialLoad
• targeting

Contoh

JavaScript

// Get the value of the `targeting` setting.
const targetingConfig = googletag.getConfig("targeting");

// Get the value of the `adsenseAttributes` and `disableInitialLoad` settings.
const config = googletag.getConfig(["adsenseAttributes", "disableInitialLoad"]);

JavaScript (lama)

// Get the value of the `targeting` setting.
var targetingConfig = googletag.getConfig("targeting");

// Get the value of the `adsenseAttributes` and `disableInitialLoad` settings.
var config = googletag.getConfig(["adsenseAttributes", "disableInitialLoad"]);

TypeScript

// Get the value of the `targeting` setting.
const targetingConfig = googletag.getConfig("targeting");

// Get the value of the `adsenseAttributes` and `disableInitialLoad` settings.
const config = googletag.getConfig(["adsenseAttributes", "disableInitialLoad"]);

Parameter
keys: string | string[]	Kunci opsi konfigurasi yang akan diambil.

Hasil
Readonly<Pick<PageSettingsConfig, "adsenseAttributes" | "disableInitialLoad" | "targeting">>	Salinan opsi konfigurasi yang dibekukan untuk halaman.

---

getVersion

getVersion(): string

Menampilkan versi GPT saat ini.

Lihat juga

• Histori versi GPT

Hasil
string	String versi GPT yang sedang dieksekusi.

---

openConsole

openConsole(div?: string): void

Membuka Konsol Penayang Google.

Contoh

JavaScript

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

// Calling without div ID.
googletag.openConsole();

JavaScript (lama)

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

Lihat juga

• Konsol Penayang Google

Parameter
Optional div: string	ID div slot iklan. Nilai ini bersifat opsional. Jika diberikan, Konsol Penayang akan mencoba membuka dengan detail slot iklan yang ditentukan dalam tampilan.

---

pubads

pubads(): PubAdsService

Menampilkan referensi ke PubAdsService.

Hasil
PubAdsService	Layanan Iklan Penayang.

---

setAdIframeTitle

setAdIframeTitle(title: string): void

Menetapkan judul untuk semua iframe penampung iklan yang dibuat oleh PubAdsService, mulai saat ini dan seterusnya.

Contoh

JavaScript

googletag.setAdIframeTitle("title");

JavaScript (lama)

googletag.setAdIframeTitle("title");

TypeScript

googletag.setAdIframeTitle("title");

Parameter
title: string	Judul baru untuk semua iframe penampung iklan.

---

setConfig

setConfig(config: PageSettingsConfig): void

Menetapkan opsi konfigurasi umum untuk halaman.

Parameter
config: PageSettingsConfig

---

sizeMapping

sizeMapping(): SizeMappingBuilder

Membuat SizeMappingBuilder baru.

Lihat juga

• Ukuran iklan: Iklan responsif

Hasil
SizeMappingBuilder	Builder baru.

---

googletag.CommandArray

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

Metode
push	Menjalankan urutan fungsi yang ditentukan dalam argumen secara berurutan.

Metode

---

push

push(...f: ((this: typeof globalThis) => void)[]): number

Menjalankan urutan fungsi yang ditentukan dalam argumen secara berurutan.

Contoh

JavaScript

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

JavaScript (lama)

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

Parameter
Rest ...f: ((this: typeof globalThis) => void)[]	Fungsi JavaScript yang akan dieksekusi. Binding runtime akan selalu berupa globalThis. Sebaiknya teruskan fungsi panah untuk mempertahankan nilai this dari konteks leksikal yang disertakan.

Hasil
number	Jumlah perintah yang diproses sejauh ini. Hal ini kompatibel dengan nilai yang ditampilkan Array.push (panjang array saat ini).

---

googletag.CompanionAdsService

Memperluas Service

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

Metode
addEventListener	Mendaftarkan pemroses yang memungkinkan Anda menyiapkan dan memanggil fungsi JavaScript saat peristiwa GPT tertentu terjadi di halaman. Diwarisi dari metode Service.addEventListener
getSlots	Dapatkan daftar slot yang terkait dengan layanan ini. Diwarisi dari metode Service.getSlots
removeEventListener	Menghapus pemroses yang terdaftar sebelumnya. Diwarisi dari metode Service.removeEventListener
setRefreshUnfilledSlots	Menetapkan apakah slot pengiring yang belum diisi akan diisi ulang secara otomatis.

Lihat juga

• Iklan pengiring untuk video dan audio

Metode

---

setRefreshUnfilledSlots

setRefreshUnfilledSlots(value: boolean): void

Menetapkan apakah slot pengiring yang belum diisi akan diisi ulang secara otomatis.

Metode ini dapat dipanggil beberapa kali selama masa aktif halaman untuk mengaktifkan dan menonaktifkan pengisian ulang. Hanya slot yang juga terdaftar di PubAdsService yang akan diisi ulang. Karena batasan kebijakan, metode ini tidak dirancang untuk mengisi slot pengiring yang kosong saat video Ad Exchange ditayangkan.

Contoh

JavaScript

googletag.companionAds().setRefreshUnfilledSlots(true);

JavaScript (lama)

googletag.companionAds().setRefreshUnfilledSlots(true);

TypeScript

googletag.companionAds().setRefreshUnfilledSlots(true);

Parameter
value: boolean	true untuk mengisi otomatis slot yang belum terisi, false untuk membiarkannya tidak berubah.

---

googletag.PrivacySettingsConfig

Objek konfigurasi untuk setelan privasi.

Properti
childDirectedTreatment?	Menunjukkan apakah halaman harus diperlakukan sebagai ditujukan untuk anak-anak.
limitedAds?	Memungkinkan penayangan berjalan dalam mode iklan terbatas untuk membantu kebutuhan kepatuhan terhadap peraturan penayang.
nonPersonalizedAds?	Memungkinkan penayangan berjalan dalam mode iklan yang tidak dipersonalisasi untuk membantu memenuhi kebutuhan kepatuhan terhadap peraturan penayang.
restrictDataProcessing?	Memungkinkan penayangan berjalan dalam mode pemrosesan yang dibatasi untuk membantu kebutuhan kepatuhan terhadap peraturan penayang.
tagForAgeTreatment?	Perlakuan yang dikenai pembatasan usia, yang menunjukkan apakah panggilan iklan harus diperlakukan sebagai anak-anak, remaja, atau tidak ditentukan.
trafficSource?	Menunjukkan apakah permintaan mewakili traffic yang dibeli atau organik.
underAgeOfConsent?	Menunjukkan apakah akan menandai panggilan iklan sebagai berasal dari pengguna di bawah usia dewasa.

Lihat juga

• Mengonfigurasi setelan privasi

Properti

---

Optional childDirectedTreatment

childDirectedTreatment?: boolean

Menunjukkan apakah halaman harus diperlakukan sebagai ditujukan untuk anak-anak. Tetapkan ke null untuk menghapus konfigurasi.

---

Optional limitedAds

limitedAds?: boolean

Memungkinkan penayangan berjalan dalam mode iklan terbatas untuk membantu kebutuhan kepatuhan terhadap peraturan penayang.

Anda dapat menginstruksikan GPT untuk meminta iklan terbatas dengan dua cara:

• Secara otomatis, dengan menggunakan sinyal dari platform pengelolaan izin TCF v2.0 IAB.
• Secara manual, dengan menetapkan nilai kolom ini ke true.

Mengonfigurasi iklan terbatas secara manual hanya dapat dilakukan jika GPT dimuat dari URL iklan terbatas. Upaya untuk mengubah setelan ini saat GPT telah dimuat dari URL standar akan menghasilkan peringatan Konsol Penayang.

Perhatikan bahwa Anda tidak perlu mengaktifkan iklan terbatas secara manual saat CMP digunakan.

Contoh

JavaScript

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

JavaScript (lama)

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

Lihat juga

• Menampilkan iklan terbatas

---

Optional nonPersonalizedAds

nonPersonalizedAds?: boolean

Memungkinkan penayangan berjalan dalam mode iklan yang tidak dipersonalisasi untuk membantu memenuhi kebutuhan kepatuhan terhadap peraturan penayang.

---

Optional restrictDataProcessing

restrictDataProcessing?: boolean

Memungkinkan penayangan berjalan dalam mode pemrosesan yang dibatasi untuk membantu memenuhi kebutuhan kepatuhan terhadap peraturan penayang.

---

Optional tagForAgeTreatment

tagForAgeTreatment?: TagForAgeTreatment

Perlakuan pembatasan usia, yang menunjukkan apakah panggilan iklan harus diperlakukan sebagai anak-anak, remaja, atau tidak ditentukan.

Konsultasikan kepada penasihat hukum Anda untuk menentukan setelan perlakuan usia bagi pengguna berdasarkan persyaratan hukum dan peraturan Anda. Untuk mengetahui informasi selengkapnya tentang setelan ini, tinjau artikel Pusat Bantuan ini.

Dengan menetapkan properti ini, Anda menyatakan bahwa pemberitahuan ini akurat dan Anda berwenang untuk bertindak atas nama pemilik situs. Anda memahami bahwa penyalahgunaan setelan ini dapat menyebabkan penghentian Akun Google Anda.

Contoh

JavaScript

// Enable teen privacy treatment.
googletag.pubads().setPrivacySettings({
  tagForAgeTreatment: googletag.enums.TagForAgeTreatment.TEEN,
});

// Clear age treatment configuration.
googletag.pubads().setPrivacySettings({
  tagForAgeTreatment: googletag.enums.TagForAgeTreatment.UNSPECIFIED,
});

JavaScript (lama)

// Enable teen privacy treatment.
googletag.pubads().setPrivacySettings({
  tagForAgeTreatment: googletag.enums.TagForAgeTreatment.TEEN,
});

// Clear age treatment configuration.
googletag.pubads().setPrivacySettings({
  tagForAgeTreatment: googletag.enums.TagForAgeTreatment.UNSPECIFIED,
});

TypeScript

// Enable teen privacy treatment.
googletag.pubads().setPrivacySettings({
  tagForAgeTreatment: googletag.enums.TagForAgeTreatment.TEEN,
});

// Clear age treatment configuration.
googletag.pubads().setPrivacySettings({
  tagForAgeTreatment: googletag.enums.TagForAgeTreatment.UNSPECIFIED,
});

---

Optional trafficSource

trafficSource?: TrafficSource

Menunjukkan apakah permintaan mewakili traffic yang dibeli atau organik. Nilai ini mengisi dimensi Sumber traffic dalam pelaporan Ad Manager. Jika tidak ditetapkan, sumber traffic akan ditetapkan secara default ke undefined dalam pelaporan.

Contoh

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

JavaScript (lama)

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

---

Optional underAgeOfConsent

underAgeOfConsent?: boolean

Menunjukkan apakah akan menandai panggilan iklan sebagai berasal dari pengguna di bawah usia dewasa. Tetapkan ke null untuk menghapus konfigurasi.

---

googletag.PubAdsService

Memperluas Service

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

Metode
addEventListener	Mendaftarkan pemroses yang memungkinkan Anda menyiapkan dan memanggil fungsi JavaScript saat peristiwa GPT tertentu terjadi di halaman. Diwarisi dari metode Service.addEventListener
clear	Menghapus iklan dari slot yang ditentukan dan menggantinya dengan konten kosong.
clearCategoryExclusions	Tidak digunakan lagi. Menghapus semua label pengecualian kategori iklan tingkat halaman.
clearTargeting	Tidak digunakan lagi. Menghapus parameter penargetan kustom untuk kunci tertentu atau untuk semua kunci.
collapseEmptyDivs	Tidak digunakan lagi. Mengaktifkan penciutan div slot sehingga tidak menggunakan ruang apa pun di halaman saat tidak ada konten iklan yang ditampilkan.
disableInitialLoad	Tidak digunakan lagi. Menonaktifkan permintaan iklan saat pemuatan halaman, tetapi mengizinkan iklan diminta dengan panggilan PubAdsService.refresh.
display	Membuat dan menampilkan slot iklan dengan jalur dan ukuran unit iklan tertentu.
enableLazyLoad	Tidak digunakan lagi. Mengaktifkan pemuatan lambat di GPT seperti yang ditentukan oleh objek konfigurasi.
enableSingleRequest	Tidak digunakan lagi. Mengaktifkan mode permintaan tunggal untuk mengambil beberapa iklan sekaligus.
enableVideoAds	Tidak digunakan lagi. Memberi sinyal ke GPT bahwa iklan video akan ada di halaman.
get	Tidak digunakan lagi. Menampilkan nilai untuk atribut AdSense yang terkait dengan kunci yang diberikan.
getAttributeKeys	Tidak digunakan lagi. Menampilkan kunci atribut yang telah ditetapkan pada layanan ini.
getSlots	Dapatkan daftar slot yang terkait dengan layanan ini. Diwarisi dari metode Service.getSlots
getTargeting	Tidak digunakan lagi. Menampilkan parameter penargetan tingkat layanan kustom tertentu yang telah ditetapkan.
getTargetingKeys	Tidak digunakan lagi. Menampilkan daftar semua kunci penargetan tingkat layanan kustom yang telah ditetapkan.
isInitialLoadDisabled	Tidak digunakan lagi. Menampilkan apakah permintaan awal untuk iklan berhasil dinonaktifkan atau tidak oleh panggilan PubAdsService.disableInitialLoad sebelumnya.
refresh	Mengambil dan menampilkan iklan baru untuk slot tertentu atau semua slot di halaman.
registerRequestHook	Mendaftarkan hook yang akan dijalankan secara paralel dengan hook terdaftar lainnya sebelum setiap permintaan iklan di halaman dalam waktu tunggu global.
removeEventListener	Menghapus pemroses yang terdaftar sebelumnya. Diwarisi dari metode Service.removeEventListener
set	Tidak digunakan lagi. Menetapkan nilai untuk atribut AdSense yang berlaku untuk semua slot iklan di layanan Iklan Penayang.
setCategoryExclusion	Tidak digunakan lagi. Menetapkan pengecualian kategori iklan tingkat halaman untuk nama label yang diberikan.
setCentering	Tidak digunakan lagi. Mengaktifkan dan menonaktifkan pemusatan iklan secara horizontal.
setForceSafeFrame	Tidak digunakan lagi. Mengonfigurasi apakah semua iklan di halaman harus dipaksa untuk dirender menggunakan penampung SafeFrame.
setLocation	Tidak digunakan lagi. Meneruskan informasi lokasi dari situs sehingga Anda dapat melakukan penargetan geografis item baris ke lokasi tertentu.
setPrivacySettings	Memungkinkan konfigurasi semua setelan privasi dari satu API menggunakan objek konfigurasi.
setPublisherProvidedId	Menetapkan nilai untuk ID yang diberikan penayang.
setSafeFrameConfig	Tidak digunakan lagi. Menetapkan preferensi tingkat halaman untuk konfigurasi SafeFrame.
setTargeting	Tidak digunakan lagi. Menetapkan parameter penargetan kustom untuk kunci tertentu yang berlaku untuk semua slot iklan layanan Iklan Penayang.
setVideoContent	Tidak digunakan lagi. Menetapkan informasi konten video yang akan dikirim bersama dengan panggilan iklan untuk tujuan penargetan dan pengecualian konten.
updateCorrelator	Mengubah korelator yang dikirim dengan panggilan iklan, yang secara efektif memulai tayangan halaman baru.

Metode

---

clear

clear(slots?: Slot[]): boolean

Menghapus iklan dari slot yang ditentukan dan menggantinya dengan konten kosong. Slot akan ditandai sebagai belum diambil.

Secara khusus, menghapus slot akan menghapus iklan dari tayangan halaman yang berjalan lama GPT, sehingga permintaan mendatang tidak akan dipengaruhi oleh roadblock atau pengecualian kompetitif yang melibatkan iklan ini.

Contoh

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

JavaScript (lama)

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

Parameter
Optional slots: Slot[]	Array slot yang akan dihapus. Array bersifat opsional; semua slot akan dihapus jika tidak ditentukan.

Hasil
boolean	Menampilkan true jika slot telah dihapus, false jika tidak.

---

clearCategoryExclusions

clearCategoryExclusions(): PubAdsService

Menghapus semua label pengecualian kategori iklan tingkat halaman. Hal ini berguna jika Anda ingin memuat ulang slot.

Tidak digunakan lagi: Gunakan PageSettingsConfig.categoryExclusion sebagai gantinya.

Contoh

JavaScript

// Set category exclusion to exclude ads with 'AirlineAd' labels.
googletag.setConfig({
  categoryExclusion: ["AirlineAd"],
});

// Make ad requests. No ad with 'AirlineAd' label will be returned.

// Clear category exclusions so all ads can be returned.
googletag.setConfig({
  categoryExclusion: null,
});

// Make ad requests. Any ad can be returned.

JavaScript (lama)

// Set category exclusion to exclude ads with 'AirlineAd' labels.
googletag.setConfig({
  categoryExclusion: ["AirlineAd"],
});

// Make ad requests. No ad with 'AirlineAd' label will be returned.

// Clear category exclusions so all ads can be returned.
googletag.setConfig({
  categoryExclusion: null,
});

// Make ad requests. Any ad can be returned.

TypeScript

// Set category exclusion to exclude ads with 'AirlineAd' labels.
googletag.setConfig({
  categoryExclusion: ["AirlineAd"],
});

// Make ad requests. No ad with 'AirlineAd' label will be returned.

// Clear category exclusions so all ads can be returned.
googletag.setConfig({
  categoryExclusion: null,
});

// Make ad requests. Any ad can be returned.

Lihat juga

• Label khusus untuk memblokir iklan

Hasil
PubAdsService	Objek layanan tempat metode dipanggil.

---

clearTargeting

clearTargeting(key?: string): PubAdsService

Menghapus parameter penargetan kustom untuk kunci tertentu atau untuk semua kunci.

Tidak digunakan lagi: Gunakan PageSettingsConfig.targeting sebagai gantinya.

Contoh

JavaScript

googletag.setConfig({
  targeting: {
    interests: "sports",
    colors: "blue",
    fruits: "apple",
  },
});

googletag.setConfig({
  targeting: {
    interests: null,
  },
});
// Targeting 'colors' and 'fruits' are still present, while 'interests'
// was cleared.

googletag.setConfig({
  targeting: null,
});
// All targeting has been cleared.

JavaScript (lama)

googletag.setConfig({
  targeting: {
    interests: "sports",
    colors: "blue",
    fruits: "apple",
  },
});

googletag.setConfig({
  targeting: {
    interests: null,
  },
});
// Targeting 'colors' and 'fruits' are still present, while 'interests'
// was cleared.

googletag.setConfig({
  targeting: null,
});
// All targeting has been cleared.

TypeScript

googletag.setConfig({
  targeting: {
    interests: "sports",
    colors: "blue",
    fruits: "apple",
  },
});

googletag.setConfig({
  targeting: {
    interests: null,
  },
});
// Targeting 'colors' and 'fruits' are still present, while 'interests'
// was cleared.

googletag.setConfig({
  targeting: null,
});
// All targeting has been cleared.

Lihat juga

• Penargetan nilai kunci

Parameter
Optional key: string	Kunci parameter penargetan. Kunci bersifat opsional; semua parameter penargetan akan dihapus jika tidak ditentukan.

Hasil
PubAdsService	Objek layanan tempat metode dipanggil.

---

collapseEmptyDivs

collapseEmptyDivs(collapseBeforeAdFetch?: boolean): boolean

Mengaktifkan penciutan div slot sehingga tidak menggunakan ruang apa pun di halaman saat tidak ada konten iklan yang ditampilkan. Mode ini harus ditetapkan sebelum layanan diaktifkan.

Tidak digunakan lagi: Gunakan PageSettingsConfig.collapseDiv sebagai gantinya.

Lihat juga

• Menciutkan slot iklan kosong
• Meminimalkan pergeseran tata letak

Parameter
Optional collapseBeforeAdFetch: boolean	Apakah akan menciutkan slot bahkan sebelum iklan diambil. Parameter ini bersifat opsional; jika tidak diberikan, false akan digunakan sebagai nilai default.

Hasil
boolean	Menampilkan true jika mode ciutkan div diaktifkan dan false jika mode ciutkan tidak dapat diaktifkan karena metode dipanggil setelah layanan diaktifkan.

---

disableInitialLoad

disableInitialLoad(): void

Menonaktifkan permintaan iklan saat pemuatan halaman, tetapi mengizinkan iklan diminta dengan panggilan PubAdsService.refresh. Hal ini harus ditetapkan sebelum mengaktifkan layanan. Mode asinkron harus digunakan; jika tidak, permintaan iklan menggunakan refresh tidak akan dapat dilakukan.

Tidak digunakan lagi: Gunakan PageSettingsConfig.disableInitialLoad sebagai gantinya.

Lihat juga

• Mengontrol pemuatan dan pemuatan ulang iklan
• Mengontrol pengelompokan SRA

---

layar

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

Membuat dan menampilkan slot iklan dengan jalur dan ukuran unit iklan yang diberikan.

Metode ini adalah singkatan yang setara dengan memanggil googletag.defineSlot yang langsung diikuti oleh googletag.display.

Perilaku metode ini bergantung pada apakah Arsitektur Permintaan Tunggal (SRA) diaktifkan:

• SRA diaktifkan: Semua slot iklan yang ditentukan hingga titik panggilan ini akan dikelompokkan dan diminta bersama-sama.
• SRA dinonaktifkan (default): Slot iklan akan diminta satu per satu.

Catatan: Saat metode ini dipanggil, snapshot status slot dan halaman akan dibuat untuk memastikan konsistensi saat mengirim panggilan iklan dan merender respons. Setiap perubahan yang dilakukan pada slot atau status halaman setelah metode ini dipanggil (termasuk penargetan, setelan privasi, paksa SafeFrame, dll.) hanya akan berlaku untuk permintaan display() atau refresh() berikutnya.

Contoh

JavaScript

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

JavaScript (lama)

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

TypeScript

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

Lihat juga

• Menampilkan iklan pengujian
• Mengontrol pemuatan dan pemuatan ulang iklan

Parameter
adUnitPath: string	Jalur unit iklan slot yang akan dirender.
size: GeneralSize	Lebar dan tinggi slot.
Optional div: string | Element	ID div yang berisi slot atau elemen div itu sendiri.
Optional clickUrl: string	URL klik yang akan digunakan di slot ini.

---

enableLazyLoad

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

Mengaktifkan pemuatan lambat di GPT seperti yang ditentukan oleh objek konfigurasi. Untuk contoh yang lebih mendetail, lihat contoh Pemuatan lambat.

Catatan: Pengambilan lambat di SRA hanya berfungsi jika semua slot berada di luar margin pengambilan.

Tidak digunakan lagi: Gunakan PageSettingsConfig.lazyLoad sebagai gantinya.

Contoh

JavaScript

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

JavaScript (lama)

googletag.setConfig({
  lazyLoad: {
    // 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.setConfig({
  lazyLoad: {
    // Fetch slots within 5 viewports.
    fetchMarginPercent: 500,
    // Render slots within 2 viewports.
    renderMarginPercent: 200,
    // Double the above values on mobile.
    mobileScaling: 2.0,
  },
});

Lihat juga

• Praktik terbaik iklan: Prioritaskan slot iklan "penting"
• Pemuatan lambat

Parameter

Optional config: {   fetchMarginPercent?: number;   mobileScaling?: number;   renderMarginPercent?: number; }

Objek konfigurasi memungkinkan penyesuaian perilaku lambat. Konfigurasi yang dihilangkan akan menggunakan setelan default yang ditetapkan oleh Google yang akan disesuaikan seiring waktu. Untuk menonaktifkan setelan tertentu, seperti margin pengambilan, tetapkan nilai ke -1. fetchMarginPercent Jarak minimum dari area pandang saat ini yang harus dimiliki slot sebelum kami mengambil iklan sebagai persentase ukuran area pandang. Nilai 0 berarti "saat slot memasuki area pandang", 100 berarti "saat iklan berjarak 1 area pandang", dan seterusnya. renderMarginPercent Jarak minimum dari area pandang saat ini yang harus dimiliki slot sebelum kami merender iklan. Hal ini memungkinkan pengambilan data iklan terlebih dahulu, tetapi menunggu untuk merender dan mendownload subresource lainnya. Nilai ini berfungsi seperti fetchMarginPercent sebagai persentase area pandang. mobileScaling Pengganda yang diterapkan ke margin di perangkat seluler. Hal ini memungkinkan margin yang bervariasi di perangkat seluler vs. desktop. Misalnya, nilai 2,0 akan mengalikan semua margin dengan 2 di perangkat seluler, sehingga meningkatkan jarak minimum yang dapat dimiliki slot sebelum pengambilan dan rendering.

---

enableSingleRequest

enableSingleRequest(): boolean

Mengaktifkan mode permintaan tunggal untuk mengambil beberapa iklan sekaligus. Hal ini mengharuskan semua slot Iklan Penayang ditentukan dan ditambahkan ke PubAdsService sebelum mengaktifkan layanan. Mode permintaan tunggal harus ditetapkan sebelum layanan diaktifkan.

Tidak digunakan lagi: Gunakan PageSettingsConfig.singleRequest sebagai gantinya.

Lihat juga

• Praktik terbaik iklan: Menggunakan Arsitektur Permintaan Tunggal dengan benar
• Mengontrol pengelompokan SRA

Hasil
boolean	Menampilkan true jika mode permintaan tunggal diaktifkan dan false jika mode permintaan tunggal tidak dapat diaktifkan karena metode dipanggil setelah layanan diaktifkan.

---

enableVideoAds

enableVideoAds(): void

Memberi sinyal ke GPT bahwa iklan video akan ada di halaman. Tindakan ini akan mengaktifkan batasan pengecualian kompetitif pada iklan Display dan video. Jika konten video diketahui, panggil PubAdsService.setVideoContent agar dapat menggunakan pengecualian konten untuk iklan Display.

Tidak digunakan lagi: Gunakan PageSettingsConfig.videoAds sebagai gantinya.

---

get

get(key: string): string

Menampilkan nilai untuk atribut AdSense yang terkait dengan kunci yang diberikan.

Tidak digunakan lagi: Gunakan googletag.getConfig sebagai gantinya.

Contoh

JavaScript

googletag.setConfig({
  adsenseAttributes: {
    page_url: "http://www.example.com",
  },
});

const adsenseConfig = googletag.getConfig("adsenseAttributes").adsenseAttributes;
const pageUrl = adsenseConfig?.page_url || null;
// Returns 'http://www.example.com'.

JavaScript (lama)

googletag.setConfig({
  adsenseAttributes: {
    page_url: "http://www.example.com",
  },
});

var adsenseConfig = googletag.getConfig("adsenseAttributes").adsenseAttributes;
var pageUrl =
  (adsenseConfig === null || adsenseConfig === void 0 ? void 0 : adsenseConfig.page_url) || null;
// Returns 'http://www.example.com'.

TypeScript

googletag.setConfig({
  adsenseAttributes: {
    page_url: "http://www.example.com",
  },
});

const adsenseConfig = googletag.getConfig("adsenseAttributes").adsenseAttributes;
const pageUrl = adsenseConfig?.page_url || null;
// Returns 'http://www.example.com'.

Lihat juga

• Atribut AdSense

Parameter
key: string	Nama atribut yang akan dicari.

Hasil
string	Nilai saat ini untuk kunci atribut, atau null jika kunci tidak ada.

---

getAttributeKeys

getAttributeKeys(): string[]

menampilkan kunci atribut yang telah ditetapkan pada layanan ini.

Tidak digunakan lagi: Gunakan googletag.getConfig sebagai gantinya.

Contoh

JavaScript

googletag.setConfig({
  adsenseAttributes: {
    page_url: "http://www.example.com",
    document_language: "en",
  },
});

const adsenseConfig = googletag.getConfig("adsenseAttributes").adsenseAttributes;
const adsenseAttributes = Object.keys(adsenseConfig || {});
// Returns ['page_url', 'document_language'].

JavaScript (lama)

googletag.setConfig({
  adsenseAttributes: {
    page_url: "http://www.example.com",
    document_language: "en",
  },
});

var adsenseConfig = googletag.getConfig("adsenseAttributes").adsenseAttributes;
var adsenseAttributes = Object.keys(adsenseConfig || {});
// Returns ['page_url', 'document_language'].

TypeScript

googletag.setConfig({
  adsenseAttributes: {
    page_url: "http://www.example.com",
    document_language: "en",
  },
});

const adsenseConfig = googletag.getConfig("adsenseAttributes").adsenseAttributes;
const adsenseAttributes = Object.keys(adsenseConfig || {});
// Returns ['page_url', 'document_language'].

Hasil
string[]	Array kunci atribut yang ditetapkan pada layanan ini. Pengurutan tidak ditentukan.

---

getTargeting

getTargeting(key: string): string[]

Menampilkan parameter penargetan tingkat layanan kustom tertentu yang telah ditetapkan.

Tidak digunakan lagi: Gunakan googletag.getConfig sebagai gantinya.

Contoh

JavaScript

googletag.setConfig({
  targeting: {
    interests: "sports",
  },
});

const targetingConfig = googletag.getConfig("targeting").targeting;

// Get targeting for a specific key.
const targeting = targetingConfig?.["interests"] || [];
// Returns ['sports'].

const ageTargeting = targetingConfig?.["age"] || [];
// Returns [] (empty array).

JavaScript (lama)

googletag.setConfig({
  targeting: {
    interests: "sports",
  },
});

var targetingConfig = googletag.getConfig("targeting").targeting;

// Get targeting for a specific key.
var targeting =
  (targetingConfig === null || targetingConfig === void 0
    ? void 0
    : targetingConfig["interests"]) || [];
// Returns ['sports'].

var ageTargeting =
  (targetingConfig === null || targetingConfig === void 0 ? void 0 : targetingConfig["age"]) || [];
// Returns [] (empty array).

TypeScript

googletag.setConfig({
  targeting: {
    interests: "sports",
  },
});

const targetingConfig = googletag.getConfig("targeting").targeting;

// Get targeting for a specific key.
const targeting = targetingConfig?.["interests"] || [];
// Returns ['sports'].

const ageTargeting = targetingConfig?.["age"] || [];
// Returns [] (empty array).

Parameter
key: string	Kunci penargetan yang akan dicari.

Hasil
string[]	Nilai yang terkait dengan kunci ini, atau array kosong jika tidak ada kunci tersebut.

---

getTargetingKeys

getTargetingKeys(): string[]

Menampilkan daftar semua kunci penargetan tingkat layanan kustom yang telah ditetapkan.

Tidak digunakan lagi: Gunakan googletag.getConfig sebagai gantinya.

Contoh

JavaScript

googletag.setConfig({
  targeting: {
    interests: "sports",
    colors: "blue",
  },
});

const targetingConfig = googletag.getConfig("targeting").targeting;
const keys = Object.keys(targetingConfig || {});
// Returns ['interests', 'colors'].

JavaScript (lama)

googletag.setConfig({
  targeting: {
    interests: "sports",
    colors: "blue",
  },
});

var targetingConfig = googletag.getConfig("targeting").targeting;
var keys = Object.keys(targetingConfig || {});
// Returns ['interests', 'colors'].

TypeScript

googletag.setConfig({
  targeting: {
    interests: "sports",
    colors: "blue",
  },
});

const targetingConfig = googletag.getConfig("targeting").targeting;
const keys = Object.keys(targetingConfig || {});
// Returns ['interests', 'colors'].

Hasil
string[]	Array kunci penargetan. Pengurutan tidak ditentukan.

---

isInitialLoadDisabled

isInitialLoadDisabled(): boolean

Menampilkan apakah permintaan awal untuk iklan berhasil dinonaktifkan atau tidak oleh panggilan PubAdsService.disableInitialLoad sebelumnya.

Tidak digunakan lagi: Gunakan googletag.getConfig sebagai gantinya.

Hasil
boolean	Menampilkan true jika panggilan sebelumnya ke PubAdsService.disableInitialLoad berhasil, false jika tidak.

---

refresh

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

Mengambil dan menampilkan iklan baru untuk slot tertentu atau semua slot di halaman. Hanya berfungsi dalam mode rendering asinkron.

Agar berfungsi dengan baik di semua browser, pemanggilan refresh harus didahului dengan pemanggilan untuk display slot iklan. Jika panggilan ke display dihilangkan, refresh mungkin berperilaku tidak terduga. Jika diinginkan, metode PubAdsService.disableInitialLoad dapat digunakan untuk menghentikan display mengambil iklan.

Memuat ulang slot akan menghapus iklan lama dari tayangan halaman yang berjalan lama GPT, sehingga permintaan mendatang tidak akan dipengaruhi oleh iklan roadblock atau pengecualian kompetitif yang melibatkan iklan tersebut.

Contoh

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

JavaScript (lama)

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

Lihat juga

• Mengontrol pemuatan dan pemuatan ulang iklan
• Memuat ulang slot iklan

Parameter
Optional slots: Slot[]	Slot yang akan dimuat ulang. Array bersifat opsional; semua slot akan dimuat ulang jika tidak ditentukan.
Optional options: {   changeCorrelator: boolean; }	Opsi konfigurasi yang terkait dengan panggilan refresh ini. changeCorrelator Menentukan apakah korelator baru akan dibuat atau tidak untuk mengambil iklan. Server iklan kami mempertahankan nilai korelator ini secara singkat (saat ini selama 30 detik, tetapi dapat berubah), sehingga permintaan dengan korelator yang sama yang diterima dalam waktu berdekatan akan dianggap sebagai satu tayangan halaman. Secara default, korelatif baru dibuat untuk setiap pemuatan ulang. Catatan: opsi ini tidak berpengaruh pada tayangan halaman yang berjalan lama GPT, yang otomatis mencerminkan iklan yang saat ini ada di halaman dan tidak memiliki waktu habis masa berlaku.

---

registerRequestHook

registerRequestHook(hook: RequestHook, hookId: string): (() => void)

Experimental Mendaftarkan hook yang akan dijalankan secara paralel dengan hook terdaftar lainnya sebelum setiap panggilan iklan di halaman dalam waktu tunggu global.

Contoh

JavaScript

// Register a request hook.
const unregister = googletag.pubads().registerRequestHook(async ({ slots }) => {
  const someAsynchronousAction = Promise.resolve();
  await someAsynchronousAction;
  for (const slot of slots) {
    slot.setConfig({ targeting: { hookApplied: "true" } });
  }
}, "my-hook");

// Unregister the hook.
unregister();

JavaScript (lama)

// Coming soon.

TypeScript

// Register a request hook.
const unregister = googletag.pubads().registerRequestHook(async ({ slots }) => {
  const someAsynchronousAction = Promise.resolve();
  await someAsynchronousAction;
  for (const slot of slots) {
    slot.setConfig({ targeting: { hookApplied: "true" } });
  }
}, "my-hook");

// Unregister the hook.
unregister();

Parameter
hook: RequestHook	Fungsi yang menggunakan objek yang berisi daftar slot yang diminta dan menampilkan promise yang di-resolve setelah semua tindakan asinkron selesai.
hookId: string	ID untuk memberi label hook guna meningkatkan diagnostik.

Hasil
(() => void)	Fungsi untuk membatalkan pendaftaran hook.

---

set

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

Menetapkan nilai untuk atribut AdSense yang berlaku untuk semua slot iklan di layanan Iklan Penayang.

Memanggil fungsi ini lebih dari sekali untuk kunci yang sama akan mengganti nilai yang ditetapkan sebelumnya untuk kunci tersebut. Semua nilai harus ditetapkan sebelum memanggil display atau refresh.

Tidak digunakan lagi: Gunakan PageSettingsConfig.adsenseAttributes sebagai gantinya.

Contoh

JavaScript

googletag.setConfig({
  adsenseAttributes: {
    page_url: "http://www.example.com",
  },
});

JavaScript (lama)

googletag.setConfig({
  adsenseAttributes: {
    page_url: "http://www.example.com",
  },
});

TypeScript

googletag.setConfig({
  adsenseAttributes: {
    page_url: "http://www.example.com",
  },
});

Lihat juga

• Atribut AdSense

Parameter
key: string	Nama atribut.
value: string	Nilai atribut.

Hasil
PubAdsService	Objek layanan tempat metode dipanggil.

---

setCategoryExclusion

setCategoryExclusion(categoryExclusion: string): PubAdsService

Menetapkan pengecualian kategori iklan tingkat halaman untuk nama label yang diberikan.

Tidak digunakan lagi: Gunakan PageSettingsConfig.categoryExclusion sebagai gantinya.

Contoh

JavaScript

// Label = AirlineAd.
googletag.setConfig({
  categoryExclusion: ["AirlineAd"],
});

JavaScript (lama)

// Label = AirlineAd.
googletag.setConfig({
  categoryExclusion: ["AirlineAd"],
});

TypeScript

// Label = AirlineAd.
googletag.setConfig({
  categoryExclusion: ["AirlineAd"],
});

Lihat juga

• Label khusus untuk memblokir iklan

Parameter
categoryExclusion: string	Label pengecualian kategori iklan yang akan ditambahkan.

Hasil
PubAdsService	Objek layanan tempat metode dipanggil.

---

setCentering

setCentering(centerAds: boolean): void

Mengaktifkan dan menonaktifkan pemusatan iklan secara horizontal. Pemusatan dinonaktifkan secara default. Di gpt_mobile.js lama, pemusatan diaktifkan secara default.

Metode ini harus dipanggil sebelum memanggil display atau refresh karena hanya iklan yang diminta setelah memanggil metode ini yang akan dipusatkan.

Tidak digunakan lagi: Gunakan PageSettingsConfig.centering sebagai gantinya.

Contoh

JavaScript

// Make ads centered.
googletag.setConfig({
  centering: true,
});

JavaScript (lama)

// Make ads centered.
googletag.setConfig({
  centering: true,
});

TypeScript

// Make ads centered.
googletag.setConfig({
  centering: true,
});

Parameter
centerAds: boolean	true untuk memusatkan iklan, false untuk meratakannya ke kiri.

---

setForceSafeFrame

setForceSafeFrame(forceSafeFrame: boolean): PubAdsService

Mengonfigurasi apakah semua iklan di halaman harus dipaksa untuk dirender menggunakan penampung SafeFrame.

Perhatikan hal-hal berikut saat menggunakan API ini:

• Setelan ini hanya akan berlaku untuk panggilan iklan berikutnya yang dibuat untuk slot yang bersangkutan.
• Setelan tingkat slot, jika ditentukan, akan selalu menggantikan setelan tingkat halaman.
• Jika ditetapkan ke true (di tingkat slot atau tingkat halaman), iklan akan selalu dirender menggunakan penampung SafeFrame, terlepas dari pilihan yang dibuat di UI Google Ad Manager.
• Namun, jika ditetapkan ke false atau tidak ditentukan, iklan akan dirender menggunakan penampung SafeFrame, bergantung pada jenis materi iklan dan pilihan yang dibuat di UI Google Ad Manager.
• API ini harus digunakan dengan hati-hati karena dapat memengaruhi perilaku materi iklan yang mencoba keluar dari iFrame atau mengandalkan materi iklan yang dirender langsung di halaman penayang.

Tidak digunakan lagi: Gunakan PageSettingsConfig.safeFrame sebagai gantinya.

Contoh

JavaScript

googletag.setConfig({
  safeFrame: {
    forceSafeFrame: true,
  },
});

// The following slot will be opted-out of the page-level force
// SafeFrame instruction.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setConfig({
    safeFrame: {
      forceSafeFrame: 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");

JavaScript (lama)

googletag.setConfig({
  safeFrame: {
    forceSafeFrame: true,
  },
});

// The following slot will be opted-out of the page-level force
// SafeFrame instruction.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setConfig({
    safeFrame: {
      forceSafeFrame: 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.setConfig({
  safeFrame: {
    forceSafeFrame: true,
  },
});

// The following slot will be opted-out of the page-level force
// SafeFrame instruction.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")!
  .setConfig({
    safeFrame: {
      forceSafeFrame: 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");

Lihat juga

• Merender materi iklan menggunakan SafeFrame

Parameter
forceSafeFrame: boolean	true untuk memaksa semua iklan di halaman dirender di SafeFrame dan false untuk mengubah setelan sebelumnya menjadi salah. Menyetelnya ke false jika tidak ditentukan sebelumnya, tidak akan mengubah apa pun.

Hasil
PubAdsService	Objek layanan tempat metode dipanggil.

---

setLocation

setLocation(address: string): PubAdsService

Meneruskan informasi lokasi dari situs sehingga Anda dapat melakukan penargetan geografis item baris ke lokasi tertentu.

Tidak digunakan lagi: Gunakan PageSettingsConfig.location sebagai gantinya.

Contoh

JavaScript

// Postal code:
googletag.setConfig({
  location: "10001,US",
});

JavaScript (lama)

// Postal code:
googletag.setConfig({
  location: "10001,US",
});

TypeScript

// Postal code:
googletag.setConfig({
  location: "10001,US",
});

Parameter
address: string	Alamat berformat bebas.

Hasil
PubAdsService	Objek layanan tempat metode dipanggil.

---

setPrivacySettings

setPrivacySettings(privacySettings: PrivacySettingsConfig): PubAdsService

Memungkinkan konfigurasi semua setelan privasi dari satu API menggunakan objek konfigurasi.

Contoh

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

JavaScript (lama)

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

Lihat juga

• Mengonfigurasi setelan privasi
• Menampilkan iklan terbatas

Parameter
privacySettings: PrivacySettingsConfig	Objek yang berisi konfigurasi setelan privasi.

Hasil
PubAdsService	Objek layanan tempat fungsi dipanggil.

---

setPublisherProvidedId

setPublisherProvidedId(ppid: string): PubAdsService

Menetapkan nilai untuk ID yang diberikan penayang.

Contoh

JavaScript

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

JavaScript (lama)

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

TypeScript

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

Lihat juga

• Tentang ID yang diberikan penayang

Parameter
ppid: string	ID alfanumerik yang diberikan oleh penayang. Harus terdiri dari 22 hingga 150 karakter.

Hasil
PubAdsService	Objek layanan tempat metode dipanggil.

---

setSafeFrameConfig

setSafeFrameConfig(config: SafeFrameConfig): PubAdsService

Menetapkan preferensi tingkat halaman untuk konfigurasi SafeFrame. Kunci yang tidak dikenali dalam objek konfigurasi akan diabaikan. Seluruh konfigurasi akan diabaikan jika nilai yang tidak valid diteruskan untuk kunci yang dikenali.

Preferensi tingkat halaman ini akan diganti oleh preferensi tingkat slot, jika ditentukan.

Tidak digunakan lagi: Gunakan PageSettingsConfig.safeFrame sebagai gantinya.

Contoh

JavaScript

googletag.setConfig({
  safeFrame: {
    forceSafeFrame: true,
    allowOverlayExpansion: true,
    allowPushExpansion: true,
    sandbox: true,
  },
});

googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setConfig({
    safeFrame: {
      allowOverlayExpansion: false,
    },
  })
  .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");

JavaScript (lama)

googletag.setConfig({
  safeFrame: {
    forceSafeFrame: true,
    allowOverlayExpansion: true,
    allowPushExpansion: true,
    sandbox: true,
  },
});

googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setConfig({
    safeFrame: {
      allowOverlayExpansion: false,
    },
  })
  .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.setConfig({
  safeFrame: {
    forceSafeFrame: true,
    allowOverlayExpansion: true,
    allowPushExpansion: true,
    sandbox: true,
  },
});

googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")!
  .setConfig({
    safeFrame: {
      allowOverlayExpansion: false,
    },
  })
  .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");

Lihat juga

• Merender materi iklan menggunakan SafeFrame

Parameter
config: SafeFrameConfig	Objek konfigurasi.

Hasil
PubAdsService	Objek layanan tempat metode dipanggil.

---

setTargeting

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

Menetapkan parameter penargetan kustom untuk kunci tertentu yang berlaku untuk semua slot iklan layanan Iklan Penayang. Memanggil fungsi ini beberapa kali untuk kunci yang sama akan menimpa nilai lama. Kunci ini ditentukan di akun Google Ad Manager Anda.

Tidak digunakan lagi: Gunakan PageSettingsConfig.targeting.

Contoh

JavaScript

// Example with a single value for a key.
googletag.setConfig({
  targeting: {
    interests: "sports",
  },
});

// Example with multiple values for a key inside in an array.
googletag.setConfig({
  targeting: {
    interests: ["sports", "music"],
  },
});

JavaScript (lama)

// Example with a single value for a key.
googletag.setConfig({
  targeting: {
    interests: "sports",
  },
});

// Example with multiple values for a key inside in an array.
googletag.setConfig({
  targeting: {
    interests: ["sports", "music"],
  },
});

TypeScript

// Example with a single value for a key.
googletag.setConfig({
  targeting: {
    interests: "sports",
  },
});

// Example with multiple values for a key inside in an array.
googletag.setConfig({
  targeting: {
    interests: ["sports", "music"],
  },
});

Lihat juga

• Penargetan nilai kunci

Parameter
key: string	Kunci parameter penargetan.
value: string | string[]	Nilai parameter penargetan atau array nilai.

Hasil
PubAdsService	Objek layanan tempat metode dipanggil.

---

setVideoContent

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

Menetapkan informasi konten video yang akan dikirim bersama dengan permintaan iklan untuk tujuan penargetan dan pengecualian konten. Iklan video akan otomatis diaktifkan saat metode ini dipanggil. Untuk videoContentId dan videoCmsId, gunakan nilai yang diberikan ke layanan penyerapan konten Google Ad Manager.

Tidak digunakan lagi: Gunakan PageSettingsConfig.videoAds sebagai gantinya.

Lihat juga

• Parameter URL tag iklan VAST

Parameter
videoContentId: string	ID konten video.
videoCmsId: string	ID CMS video.

---

updateCorrelator

updateCorrelator(): PubAdsService

Mengubah korelator yang dikirim dengan panggilan iklan, yang secara efektif memulai tayangan halaman baru. Korelator identik untuk semua panggilan iklan yang berasal dari satu tayangan halaman, dan unik di seluruh tayangan halaman. Hanya berlaku untuk mode asinkron.

Catatan: hal ini tidak memengaruhi tayangan halaman yang berjalan lama GPT, yang otomatis mencerminkan iklan yang sebenarnya ada di halaman dan tidak memiliki waktu habis masa berlaku.

Contoh

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.

JavaScript (lama)

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

Hasil
PubAdsService	Objek layanan tempat fungsi dipanggil.

---

googletag.RequestHook

Fungsi callback yang dipanggil sebelum setiap panggilan iklan saat didaftarkan melalui PubAdsService.registerRequestHook.

---

googletag.ResponseInformation

Objek yang mewakili satu respons iklan.

Properti
advertiserId	ID pengiklan.
campaignId	ID kampanye.
creativeId	ID materi iklan.
creativeTemplateId	ID template iklan.
lineItemId	ID item baris.

Lihat juga

• Slot.getResponseInformation

Properti

---

advertiserId

advertiserId: number

ID pengiklan.

---

campaignId

campaignId: number

ID kampanye.

---

creativeId

creativeId: number

ID materi iklan.

---

creativeTemplateId

creativeTemplateId: number

ID template iklan.

---

lineItemId

lineItemId: number

ID item baris.

---

googletag.RewardedPayload

Objek yang mewakili reward yang terkait dengan iklan reward

Properti
amount	Jumlah item yang disertakan dalam reward.
type	Jenis item yang disertakan dalam reward (misalnya, "koin").

Lihat juga

• Menampilkan iklan reward

Properti

---

amount

amount: number

Jumlah item yang disertakan dalam reward.

---

type

type: string

Jenis item yang disertakan dalam reward (misalnya, "koin").

---

googletag.Service

Class layanan dasar yang berisi metode umum untuk semua layanan.

Metode
addEventListener	Mendaftarkan pemroses yang memungkinkan Anda menyiapkan dan memanggil fungsi JavaScript saat peristiwa GPT tertentu terjadi di halaman.
getSlots	Dapatkan daftar slot yang terkait dengan layanan ini.
removeEventListener	Menghapus pemroses yang terdaftar sebelumnya.

Metode

---

addEventListener

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

Mendaftarkan pemroses yang memungkinkan Anda menyiapkan dan memanggil fungsi JavaScript saat peristiwa GPT tertentu terjadi di halaman. Peristiwa berikut didukung:

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

Objek dari jenis peristiwa yang sesuai akan diteruskan ke pemroses saat dipanggil.

Contoh

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

JavaScript (lama)

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

Lihat juga

• Pemroses peristiwa iklan

Parameter
eventType: K	String yang mewakili jenis peristiwa yang dihasilkan oleh GPT. Jenis peristiwa peka huruf besar/kecil.
listener: ((arg: EventTypeMap[K]) => void)	Fungsi yang menggunakan satu argumen objek peristiwa.

Hasil
Service	Objek layanan tempat metode dipanggil.

---

getSlots

getSlots(): Slot[]

Dapatkan daftar slot yang terkait dengan layanan ini.

Hasil
Slot[]	Slot sesuai urutan penambahannya ke layanan.

---

removeEventListener

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

Menghapus pemroses yang terdaftar sebelumnya.

Contoh

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

JavaScript (lama)

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

Parameter
eventType: K	String yang mewakili jenis peristiwa yang dihasilkan oleh GPT. Jenis peristiwa peka huruf besar/kecil.
listener: ((event: EventTypeMap[K]) => void)	Fungsi yang menggunakan satu argumen objek peristiwa.

---

googletag.SizeMappingBuilder

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

Metode
addSize	Menambahkan pemetaan dari array ukuran tunggal (yang mewakili area pandang) ke array ukuran tunggal atau multi-ukuran yang mewakili slot.
build	Membuat spesifikasi peta ukuran dari pemetaan yang ditambahkan ke builder ini.

Lihat juga

• Ukuran iklan: Iklan responsif

Metode

---

addSize

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

Menambahkan pemetaan dari array ukuran tunggal (yang mewakili area pandang) ke array ukuran tunggal atau multi-ukuran yang mewakili slot.

Contoh

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]

JavaScript (lama)

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

Parameter
viewportSize: SingleSizeArray	Ukuran area pandang untuk entri pemetaan ini.
slotSize: GeneralSize	Ukuran slot untuk entri pemetaan ini.

Hasil
SizeMappingBuilder	Referensi ke builder ini.

---

build

build(): SizeMappingArray

Membuat spesifikasi peta ukuran dari pemetaan yang ditambahkan ke builder ini.

Jika ada pemetaan yang tidak valid, metode ini akan menampilkan null. Jika tidak, metode ini akan menampilkan spesifikasi dalam format yang benar untuk diteruskan ke Slot.defineSizeMapping.

Catatan: perilaku builder setelah memanggil metode ini tidak ditentukan.

Hasil
SizeMappingArray	Hasil yang dibuat oleh builder ini. Dapat bernilai null jika pemetaan ukuran yang tidak valid diberikan.

---

googletag.Slot

Slot adalah objek yang mewakili satu slot iklan di halaman.

Metode
addService	Menambahkan Layanan ke slot ini.
clearCategoryExclusions	Tidak digunakan lagi. Menghapus semua label pengecualian kategori iklan tingkat slot untuk slot ini.
clearTargeting	Tidak digunakan lagi. Menghapus parameter penargetan tingkat slot kustom tertentu atau semua parameter penargetan tingkat slot kustom untuk slot ini.
defineSizeMapping	Menetapkan array pemetaan dari ukuran area pandang minimum ke ukuran slot untuk slot ini.
get	Tidak digunakan lagi. Menampilkan nilai untuk atribut AdSense yang terkait dengan kunci yang diberikan untuk slot ini.
getAdUnitPath	Menampilkan jalur lengkap unit iklan, dengan kode jaringan dan jalur unit iklan.
getAttributeKeys	Tidak digunakan lagi. Menampilkan daftar kunci atribut yang ditetapkan di slot ini.
getCategoryExclusions	Tidak digunakan lagi. Menampilkan label pengecualian kategori iklan untuk slot ini.
getConfig	Mendapatkan salinan beku dari opsi konfigurasi umum untuk slot yang ditetapkan oleh setConfig.
getResponseInformation	Menampilkan informasi respons iklan.
getSlotElementId	Menampilkan ID slot div yang diberikan saat slot ditentukan.
getTargeting	Tidak digunakan lagi. Menampilkan parameter penargetan kustom tertentu yang ditetapkan di slot ini.
getTargetingKeys	Tidak digunakan lagi. Menampilkan daftar semua kunci penargetan kustom yang ditetapkan di slot ini.
set	Tidak digunakan lagi. Menetapkan nilai untuk atribut AdSense di slot iklan ini.
setCategoryExclusion	Tidak digunakan lagi. Menetapkan label pengecualian kategori iklan tingkat slot di slot ini.
setClickUrl	Tidak digunakan lagi. Menetapkan URL klik yang akan menjadi tujuan pengalihan pengguna setelah mengklik iklan.
setCollapseEmptyDiv	Tidak digunakan lagi. Menetapkan apakah slot div harus disembunyikan jika tidak ada iklan di slot tersebut.
setConfig	Menetapkan opsi konfigurasi umum untuk slot ini.
setForceSafeFrame	Tidak digunakan lagi. Mengonfigurasi apakah iklan di slot ini harus dipaksa untuk dirender menggunakan penampung SafeFrame.
setSafeFrameConfig	Tidak digunakan lagi. Menetapkan preferensi tingkat slot untuk konfigurasi SafeFrame.
setTargeting	Tidak digunakan lagi. Menetapkan parameter penargetan kustom untuk slot ini.
updateTargetingFromMap	Tidak digunakan lagi. Menetapkan parameter penargetan kustom untuk slot ini, dari peta kunci:nilai dalam objek JSON.

Metode

---

addService

addService(service: Service): Slot

Menambahkan Layanan ke slot ini.

Contoh

JavaScript

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

JavaScript (lama)

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

TypeScript

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

Lihat juga

• Mulai Menggunakan Tag Penayang Google
• Menampilkan iklan pengujian

Parameter
service: Service	Layanan yang akan ditambahkan.

Hasil
Slot	Objek slot tempat metode dipanggil.

---

clearCategoryExclusions

clearCategoryExclusions(): Slot

Menghapus semua label pengecualian kategori iklan tingkat slot untuk slot ini.

Tidak digunakan lagi: Gunakan SlotSettingsConfig.categoryExclusion sebagai gantinya.

Contoh

JavaScript

// Set category exclusion to exclude ads with 'AirlineAd' labels.
const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    categoryExclusion: ["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.setConfig({
  categoryExclusion: null,
});

// Make an ad request. Any ad can be returned for the slot.

JavaScript (lama)

// Set category exclusion to exclude ads with 'AirlineAd' labels.
var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    categoryExclusion: ["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.setConfig({
  categoryExclusion: null,
});

// 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")!
  .setConfig({
    categoryExclusion: ["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.setConfig({
  categoryExclusion: null,
});

// Make an ad request. Any ad can be returned for the slot.

Hasil
Slot	Objek slot tempat metode dipanggil.

---

clearTargeting

clearTargeting(key?: string): Slot

Menghapus parameter penargetan tingkat slot kustom tertentu atau semua parameter penargetan tingkat slot kustom untuk slot ini.

Tidak digunakan lagi: Gunakan SlotSettingsConfig.targeting sebagai gantinya.

Contoh

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    targeting: {
      allow_expandable: "true",
      interests: ["sports", "music"],
      color: "red",
    },
  })
  .addService(googletag.pubads());

slot.setConfig({
  targeting: {
    color: null,
  },
});
// Targeting 'allow_expandable' and 'interests' are still present,
// while 'color' was cleared.

slot.setConfig({
  targeting: null,
});
// All targeting has been cleared.

JavaScript (lama)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    targeting: {
      allow_expandable: "true",
      interests: ["sports", "music"],
      color: "red",
    },
  })
  .addService(googletag.pubads());

slot.setConfig({
  targeting: {
    color: null,
  },
});
// Targeting 'allow_expandable' and 'interests' are still present,
// while 'color' was cleared.

slot.setConfig({
  targeting: null,
});
// All targeting has been cleared.

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setConfig({
    targeting: {
      allow_expandable: "true",
      interests: ["sports", "music"],
      color: "red",
    },
  })
  .addService(googletag.pubads());

slot.setConfig({
  targeting: {
    color: null,
  },
});
// Targeting 'allow_expandable' and 'interests' are still present,
// while 'color' was cleared.

slot.setConfig({
  targeting: null,
});
// All targeting has been cleared.

Lihat juga

• Penargetan nilai kunci

Parameter
Optional key: string	Kunci parameter penargetan. Kunci bersifat opsional; semua parameter penargetan akan dihapus jika tidak ditentukan.

Hasil
Slot	Objek slot tempat metode dipanggil.

---

defineSizeMapping

defineSizeMapping(sizeMapping: SizeMappingArray): Slot

Menetapkan array pemetaan dari ukuran area pandang minimum ke ukuran slot untuk slot ini.

Contoh

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

JavaScript (lama)

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

Lihat juga

• Ukuran iklan: Iklan responsif

Parameter
sizeMapping: SizeMappingArray	Array pemetaan ukuran. Anda dapat menggunakan SizeMappingBuilder untuk membuatnya. Setiap pemetaan ukuran adalah array yang terdiri dari dua elemen: SingleSizeArray dan GeneralSize.

Hasil
Slot	Objek slot tempat metode dipanggil.

---

get

get(key: string): string

Menampilkan nilai untuk atribut AdSense yang terkait dengan kunci yang diberikan untuk slot ini. Untuk melihat atribut tingkat layanan yang diwarisi oleh slot ini, gunakan PubAdsService.get.

Tidak digunakan lagi: Gunakan googletag.Slot.getConfig.

Contoh

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    adsenseAttributes: {
      page_url: "http://www.example.com",
    },
  })
  .addService(googletag.pubads());

const adsenseConfig = slot.getConfig("adsenseAttributes").adsenseAttributes;
const pageUrl = adsenseConfig?.page_url || null;
// Returns 'http://www.example.com'.

JavaScript (lama)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    adsenseAttributes: {
      page_url: "http://www.example.com",
    },
  })
  .addService(googletag.pubads());

var adsenseConfig = slot.getConfig("adsenseAttributes").adsenseAttributes;
var pageUrl =
  (adsenseConfig === null || adsenseConfig === void 0 ? void 0 : adsenseConfig.page_url) || null;
// Returns 'http://www.example.com'.

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setConfig({
    adsenseAttributes: {
      page_url: "http://www.example.com",
    },
  })
  .addService(googletag.pubads());

const adsenseConfig = slot.getConfig("adsenseAttributes").adsenseAttributes;
const pageUrl = adsenseConfig?.page_url || null;
// Returns 'http://www.example.com'.

Lihat juga

• Atribut AdSense

Parameter
key: string	Nama atribut yang akan dicari.

Hasil
string	Nilai saat ini untuk kunci atribut, atau null jika kunci tidak ada.

---

getAdUnitPath

getAdUnitPath(): string

Menampilkan jalur lengkap unit iklan, dengan kode jaringan dan jalur unit iklan.

Contoh

JavaScript

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

slot.getAdUnitPath();
// Returns '/1234567/sports'.

JavaScript (lama)

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

Hasil
string	Jalur unit iklan.

---

getAttributeKeys

getAttributeKeys(): string[]

Menampilkan daftar kunci atribut yang ditetapkan di slot ini. Untuk melihat kunci atribut tingkat layanan yang diwarisi oleh slot ini, gunakan PubAdsService.getAttributeKeys.

Tidak digunakan lagi: Gunakan googletag.Slot.getConfig sebagai gantinya.

Contoh

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    adsenseAttributes: {
      page_url: "http://www.example.com",
      document_language: "en",
    },
  })
  .addService(googletag.pubads());

const adsenseConfig = slot.getConfig("adsenseAttributes").adsenseAttributes;
const adsenseAttributes = Object.keys(adsenseConfig || {});
// Returns ['page_url', 'document_language'].

JavaScript (lama)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    adsenseAttributes: {
      page_url: "http://www.example.com",
      document_language: "en",
    },
  })
  .addService(googletag.pubads());

var adsenseConfig = slot.getConfig("adsenseAttributes").adsenseAttributes;
var adsenseAttributes = Object.keys(adsenseConfig || {});
// Returns ['page_url', 'document_language'].

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setConfig({
    adsenseAttributes: {
      page_url: "http://www.example.com",
      document_language: "en",
    },
  })
  .addService(googletag.pubads());

const adsenseConfig = slot.getConfig("adsenseAttributes").adsenseAttributes;
const adsenseAttributes = Object.keys(adsenseConfig || {});
// Returns ['page_url', 'document_language'].

Hasil
string[]	Array kunci atribut. Pengurutan tidak ditentukan.

---

getCategoryExclusions

getCategoryExclusions(): string[]

Menampilkan label pengecualian kategori iklan untuk slot ini.

Tidak digunakan lagi: Gunakan googletag.Slot.getConfig sebagai gantinya.

Contoh

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    categoryExclusion: ["AirlineAd", "TrainAd"],
  })
  .addService(googletag.pubads());

const exclusions = slot.getConfig("categoryExclusion")?.categoryExclusion || [];
// Returns ['AirlineAd', 'TrainAd'].

JavaScript (lama)

var _a;
var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    categoryExclusion: ["AirlineAd", "TrainAd"],
  })
  .addService(googletag.pubads());

var exclusions =
  ((_a = slot.getConfig("categoryExclusion")) === null || _a === void 0
    ? void 0
    : _a.categoryExclusion) || [];
// Returns ['AirlineAd', 'TrainAd'].

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setConfig({
    categoryExclusion: ["AirlineAd", "TrainAd"],
  })
  .addService(googletag.pubads());

const exclusions = slot.getConfig("categoryExclusion")?.categoryExclusion || [];
// Returns ['AirlineAd', 'TrainAd'].

Hasil
string[]	Label pengecualian kategori iklan untuk slot ini, atau array kosong jika tidak ada yang ditetapkan.

---

getConfig

getConfig(keys: string | string[]): Readonly<Pick<SlotSettingsConfig, "adsenseAttributes" | "targeting" | "categoryExclusion">>

Mendapatkan salinan tetap dari opsi konfigurasi umum untuk slot yang ditetapkan oleh setConfig.

Tidak semua properti setConfig() didukung oleh metode ini. Properti yang didukung adalah:

• adsenseAttributes
• categoryExclusion
• targeting

Contoh

JavaScript

const slot = googletag.defineSlot("/1234567/sports", [160, 600], "div");

// Get the value of the `targeting` setting.
const targetingConfig = slot.getConfig("targeting");

// Get the value of the `adsenseAttributes` and `categoryExclusion` settings.
const config = slot.getConfig(["adsenseAttributes", "categoryExclusion"]);

JavaScript (lama)

var slot = googletag.defineSlot("/1234567/sports", [160, 600], "div");

// Get the value of the `targeting` setting.
var targetingConfig = slot.getConfig("targeting");

// Get the value of the `adsenseAttributes` and `categoryExclusion` settings.
var config = slot.getConfig(["adsenseAttributes", "categoryExclusion"]);

TypeScript

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

// Get the value of the `targeting` setting.
const targetingConfig = slot.getConfig("targeting");

// Get the value of the `adsenseAttributes` and `categoryExclusion` settings.
const config = slot.getConfig(["adsenseAttributes", "categoryExclusion"]);

Parameter
keys: string | string[]	Kunci opsi konfigurasi yang akan diambil.

Hasil
Readonly<Pick<SlotSettingsConfig, "adsenseAttributes" | "targeting" | "categoryExclusion">>	Salinan opsi konfigurasi yang dibekukan untuk slot.

---

getResponseInformation

getResponseInformation(): ResponseInformation

Menampilkan informasi respons iklan. Hal ini didasarkan pada respons iklan terakhir untuk slot. Jika ini dipanggil saat slot tidak memiliki iklan, null akan ditampilkan.

Hasil
ResponseInformation	Informasi respons iklan terbaru, atau null jika slot tidak memiliki iklan.

---

getSlotElementId

getSlotElementId(): string

Menampilkan ID slot div yang diberikan saat slot ditentukan.

Contoh

JavaScript

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

slot.getSlotElementId();
// Returns 'div'.

JavaScript (lama)

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

slot.getSlotElementId();
// Returns 'div'.

TypeScript

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

slot.getSlotElementId();
// Returns 'div'.

Hasil
string	ID Slot div.

---

getTargeting

getTargeting(key: string): string[]

Menampilkan parameter penargetan kustom tertentu yang ditetapkan di slot ini. Parameter penargetan tingkat layanan tidak disertakan.

Tidak digunakan lagi: Gunakan googletag.Slot.getConfig sebagai gantinya.

Contoh

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    targeting: {
      allow_expandable: "true",
    },
  })
  .addService(googletag.pubads());

const targetingConfig = slot.getConfig("targeting").targeting;

// Get targeting for a specific key.
const targeting = targetingConfig?.["allow_expandable"] || [];
// Returns ['true'].

const ageTargeting = targetingConfig?.["age"] || [];
// Returns [] (empty array).

JavaScript (lama)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    targeting: {
      allow_expandable: "true",
    },
  })
  .addService(googletag.pubads());

var targetingConfig = slot.getConfig("targeting").targeting;

// Get targeting for a specific key.
var targeting =
  (targetingConfig === null || targetingConfig === void 0
    ? void 0
    : targetingConfig["allow_expandable"]) || [];
// Returns ['true'].

var ageTargeting =
  (targetingConfig === null || targetingConfig === void 0 ? void 0 : targetingConfig["age"]) || [];
// Returns [] (empty array).

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setConfig({
    targeting: {
      allow_expandable: "true",
    },
  })
  .addService(googletag.pubads());

const targetingConfig = slot.getConfig("targeting").targeting;

// Get targeting for a specific key.
const targeting = targetingConfig?.["allow_expandable"] || [];
// Returns ['true'].

const ageTargeting = targetingConfig?.["age"] || [];
// Returns [] (empty array).

Parameter
key: string	Kunci penargetan yang akan dicari.

Hasil
string[]	Nilai yang terkait dengan kunci ini, atau array kosong jika tidak ada kunci tersebut.

---

getTargetingKeys

getTargetingKeys(): string[]

Menampilkan daftar semua kunci penargetan kustom yang ditetapkan di slot ini. Kunci penargetan tingkat layanan tidak disertakan.

Tidak digunakan lagi: Gunakan googletag.Slot.getConfig sebagai gantinya.

Contoh

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    targeting: {
      allow_expandable: "true",
      interests: ["sports", "music"],
    },
  })
  .addService(googletag.pubads());

const targetingConfig = slot.getConfig("targeting").targeting;
const keys = Object.keys(targetingConfig || {});
// Returns ['interests', 'allow_expandable'].

JavaScript (lama)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    targeting: {
      allow_expandable: "true",
      interests: ["sports", "music"],
    },
  })
  .addService(googletag.pubads());

var targetingConfig = slot.getConfig("targeting").targeting;
var keys = Object.keys(targetingConfig || {});
// Returns ['interests', 'allow_expandable'].

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setConfig({
    targeting: {
      allow_expandable: "true",
      interests: ["sports", "music"],
    },
  })
  .addService(googletag.pubads());

const targetingConfig = slot.getConfig("targeting").targeting;
const keys = Object.keys(targetingConfig || {});
// Returns ['interests', 'allow_expandable'].

Hasil
string[]	Array kunci penargetan. Pengurutan tidak ditentukan.

---

set

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

Menetapkan nilai untuk atribut AdSense di slot iklan ini. Tindakan ini akan mengganti nilai apa pun yang ditetapkan di tingkat layanan untuk kunci ini.

Memanggil metode ini lebih dari sekali untuk kunci yang sama akan mengganti nilai yang ditetapkan sebelumnya untuk kunci tersebut. Semua nilai harus ditetapkan sebelum memanggil display atau refresh.

Tidak digunakan lagi: Gunakan SlotSettingsConfig.adsenseAttributes sebagai gantinya.

Contoh

JavaScript

// Setting an attribute on a single ad slot.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    adsenseAttributes: {
      page_url: "http://www.example.com",
    },
  })
  .addService(googletag.pubads());

JavaScript (lama)

// Setting an attribute on a single ad slot.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    adsenseAttributes: {
      page_url: "http://www.example.com",
    },
  })
  .addService(googletag.pubads());

TypeScript

// Setting an attribute on a single ad slot.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setConfig({
    adsenseAttributes: {
      page_url: "http://www.example.com",
    },
  })
  .addService(googletag.pubads());

Lihat juga

• Atribut AdSense

Parameter
key: string	Nama atribut.
value: string	Nilai atribut.

Hasil
Slot	Objek slot tempat metode dipanggil.

---

setCategoryExclusion

setCategoryExclusion(categoryExclusion: string): Slot

Menetapkan label pengecualian kategori iklan tingkat slot di slot ini.

Tidak digunakan lagi: Gunakan SlotSettingsConfig.categoryExclusion.

Contoh

JavaScript

// Label = AirlineAd.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    categoryExclusion: ["AirlineAd"],
  })
  .addService(googletag.pubads());

JavaScript (lama)

// Label = AirlineAd.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .setConfig({
    categoryExclusion: ["AirlineAd"],
  })
  .addService(googletag.pubads());

TypeScript

// Label = AirlineAd.
googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .setConfig({
    categoryExclusion: ["AirlineAd"],
  })
  .addService(googletag.pubads());

Lihat juga

• Label khusus untuk memblokir iklan

Parameter
categoryExclusion: string	Label pengecualian kategori iklan yang akan ditambahkan.

Hasil
Slot	Objek slot tempat metode dipanggil.

---

setClickUrl

setClickUrl(value: string): Slot

Menetapkan URL klik yang akan menjadi tujuan pengalihan pengguna setelah mengklik iklan.

Server Google Ad Manager tetap mencatat klik meskipun URL klik diganti. URL halaman landing apa pun yang terkait dengan materi iklan yang ditayangkan akan ditambahkan ke nilai yang diberikan. Panggilan berikutnya akan menimpa nilai. Ini hanya berfungsi untuk permintaan non-SRA.

Tidak digunakan lagi: Sebagai gantinya, gunakan SlotSettingsConfig.clickUrl.

Contoh

JavaScript

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

JavaScript (lama)

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

TypeScript

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

Parameter
value: string	URL klik yang akan ditetapkan.

Hasil
Slot	Objek slot tempat metode dipanggil.

---

setCollapseEmptyDiv

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

Menetapkan apakah slot div harus disembunyikan saat tidak ada iklan di slot. Tindakan ini akan menggantikan setelan tingkat layanan.

Tidak digunakan lagi: Gunakan SlotSettingsConfig.collapseDiv sebagai gantinya.

Contoh

JavaScript

const slot1 = googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setConfig({
    collapseDiv: "BEFORE_FETCH",
  })
  .addService(googletag.pubads());
// The above will cause the div for this slot to be collapsed
// when the page is loaded, before ads are requested.

const slot2 = googletag
  .defineSlot("/1234567/sports", [160, 600], "div-2")
  .setConfig({
    collapseDiv: "ON_NO_FILL",
  })
  .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.

JavaScript (lama)

var slot1 = googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")
  .setConfig({
    collapseDiv: "BEFORE_FETCH",
  })
  .addService(googletag.pubads());
// The above will cause the div for this slot to be collapsed
// when the page is loaded, before ads are requested.

var slot2 = googletag
  .defineSlot("/1234567/sports", [160, 600], "div-2")
  .setConfig({
    collapseDiv: "ON_NO_FILL",
  })
  .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

const slot1 = googletag
  .defineSlot("/1234567/sports", [160, 600], "div-1")!
  .setConfig({
    collapseDiv: "BEFORE_FETCH",
  })
  .addService(googletag.pubads());
// The above will cause the div for this slot to be collapsed
// when the page is loaded, before ads are requested.

const slot2 = googletag
  .defineSlot("/1234567/sports", [160, 600], "div-2")!
  .setConfig({
    collapseDiv: "ON_NO_FILL",
  })
  .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.

Lihat juga

• Menciutkan slot iklan kosong
• Meminimalkan pergeseran tata letak

Parameter
collapse: boolean	Apakah akan menciutkan slot jika tidak ada iklan yang ditampilkan.
Optional collapseBeforeAdFetch: boolean	Apakah akan menciutkan slot bahkan sebelum iklan diambil. Diabaikan jika penciutan bukan true.

Hasil
Slot	Objek slot tempat metode dipanggil.

---

setConfig

setConfig(slotConfig: SlotSettingsConfig): Slot

Menetapkan opsi konfigurasi umum untuk slot ini.

Parameter
slotConfig: SlotSettingsConfig	Objek konfigurasi.

Hasil
Slot	Objek slot tempat metode dipanggil.

---

setForceSafeFrame

setForceSafeFrame(forceSafeFrame: boolean): Slot

Mengonfigurasi apakah iklan di slot ini harus dipaksa untuk dirender menggunakan penampung SafeFrame.

Perhatikan hal-hal berikut saat menggunakan API ini:

• Setelan ini hanya akan berlaku untuk panggilan iklan berikutnya yang dibuat untuk slot yang bersangkutan.
• Setelan tingkat slot, jika ditentukan, akan selalu menggantikan setelan tingkat halaman.
• Jika ditetapkan ke true (di tingkat slot atau tingkat halaman), iklan akan selalu dirender menggunakan penampung SafeFrame, terlepas dari pilihan yang dibuat di UI Google Ad Manager.
• Namun, jika ditetapkan ke false atau tidak ditentukan, iklan akan dirender menggunakan penampung SafeFrame, bergantung pada jenis materi iklan dan pilihan yang dibuat di UI Google Ad Manager.
• API ini harus digunakan dengan hati-hati karena dapat memengaruhi perilaku materi iklan yang mencoba keluar dari iFrame atau mengandalkan materi iklan yang dirender langsung di halaman penayang.

Tidak digunakan lagi: Gunakan SlotSettingsConfig.safeFrame sebagai gantinya.

Contoh

JavaScript

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

JavaScript (lama)

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

Lihat juga

• Merender materi iklan menggunakan SafeFrame

Parameter
forceSafeFrame: boolean	true untuk memaksa semua iklan di slot ini dirender di SafeFrame dan false untuk memilih tidak menggunakan setelan tingkat halaman (jika ada). Menyetelnya ke false jika tidak ditentukan di tingkat halaman tidak akan mengubah apa pun.

Hasil
Slot	Objek slot tempat metode dipanggil.

---

setSafeFrameConfig

setSafeFrameConfig(config: SafeFrameConfig): Slot

Menetapkan preferensi tingkat slot untuk konfigurasi SafeFrame. Kunci yang tidak dikenali dalam objek konfigurasi akan diabaikan. Seluruh konfigurasi akan diabaikan jika nilai yang tidak valid diteruskan untuk kunci yang dikenali.

Preferensi tingkat slot ini, jika ditentukan, akan menggantikan preferensi tingkat halaman.

Tidak digunakan lagi: Gunakan SlotSettingsConfig.safeFrame sebagai gantinya.

Contoh

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

JavaScript (lama)

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

Lihat juga

• Merender materi iklan menggunakan SafeFrame

Parameter
config: SafeFrameConfig	Objek konfigurasi.

Hasil
Slot	Objek slot tempat metode dipanggil.

---

setTargeting

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

Menetapkan parameter penargetan kustom untuk slot ini. Memanggil metode ini beberapa kali untuk kunci yang sama akan menimpa nilai lama. Nilai yang ditetapkan di sini akan menimpa parameter penargetan yang ditetapkan di tingkat layanan. Kunci ini ditentukan di akun Google Ad Manager Anda.

Tidak digunakan lagi: Sebagai gantinya, gunakan SlotSettingsConfig.targeting.

Contoh

JavaScript

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

// Example with a single value for a key.
slot.setConfig({
  targeting: {
    allow_expandable: "true",
  },
});

// Example with multiple values for a key inside in an array.
slot.setConfig({
  targeting: {
    interests: ["sports", "music"],
  },
});

JavaScript (lama)

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

// Example with a single value for a key.
slot.setConfig({
  targeting: {
    allow_expandable: "true",
  },
});

// Example with multiple values for a key inside in an array.
slot.setConfig({
  targeting: {
    interests: ["sports", "music"],
  },
});

TypeScript

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

// Example with a single value for a key.
slot.setConfig({
  targeting: {
    allow_expandable: "true",
  },
});

// Example with multiple values for a key inside in an array.
slot.setConfig({
  targeting: {
    interests: ["sports", "music"],
  },
});

Lihat juga

• Penargetan nilai kunci

Parameter
key: string	Kunci parameter penargetan.
value: string | string[]	Nilai parameter penargetan atau array nilai.

Hasil
Slot	Objek slot tempat metode dipanggil.

---

updateTargetingFromMap

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

Menetapkan parameter penargetan kustom untuk slot ini, dari peta kunci:nilai dalam objek JSON. Hal ini sama dengan memanggil Slot.setTargeting untuk semua nilai kunci objek. Kunci ini ditentukan di akun Google Ad Manager Anda.

Catatan:

• Jika terjadi penimpaan, hanya nilai terakhir yang akan disimpan.
• Jika nilainya adalah array, nilai sebelumnya akan ditimpa, bukan digabungkan.
• Nilai yang ditetapkan di sini akan menimpa parameter penargetan yang ditetapkan di tingkat layanan.

Tidak digunakan lagi: Gunakan SlotSettingsConfig.targeting sebagai gantinya.

Contoh

JavaScript

const slot = googletag.defineSlot("/1234567/sports", [160, 600], "div");

slot.updateTargetingFromMap({
  color: "red",
  interests: ["sports", "music", "movies"],
});

JavaScript (lama)

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

Parameter
map: {   [adUnitPath: string]: string | string[]; }	Peta key:value parameter penargetan.

Hasil
Slot	Objek slot tempat metode dipanggil.

---

googletag.config

Antarmuka konfigurasi utama untuk setelan tingkat halaman.

Antarmuka
AdExpansionConfig	Setelan untuk mengontrol perluasan iklan.
AdSenseAttributesConfig	Setelan untuk mengontrol perilaku iklan AdSense.
AutoRefreshConfig	Setelan konfigurasi refresh otomatis.
ContinueButtonConfig	Setelan untuk mengonfigurasi perilaku tombol lanjutkan.
InterstitialConfig	Objek yang menentukan perilaku satu slot iklan interstisial.
LazyLoadConfig	Setelan untuk mengontrol penggunaan pemuatan lambat di GPT.
PageSettingsConfig	Antarmuka konfigurasi utama untuk setelan tingkat halaman.
PrivacyTreatmentsConfig	Setelan untuk mengontrol perlakuan privasi penayang.
PublisherProvidedSignalsConfig	Objek konfigurasi sinyal yang diberikan penayang (PPS).
SafeFrameConfig	Setelan untuk mengontrol SafeFrame di GPT.
SlotSettingsConfig	Antarmuka konfigurasi utama untuk setelan tingkat slot.
TaxonomyData	Objek yang berisi nilai untuk satu Taksonomi.
VideoAdsConfig	Setelan untuk mengonfigurasi setelan terkait iklan video.

Alias Jenis
CollapseDivBehavior	Nilai yang didukung untuk mengontrol perilaku penciutan slot iklan.
InterstitialTrigger	Pemicu iklan interstisial yang didukung.
PrivacyTreatment	Perlakuan privasi penayang yang didukung.
Taxonomy	Taksonomi yang didukung untuk sinyal yang diberikan penayang (PPS).

Alias Jenis

---

CollapseDivBehavior

CollapseDivBehavior: "DISABLED" | "BEFORE_FETCH" | "ON_NO_FILL"

Nilai yang didukung untuk mengontrol perilaku penciutan slot iklan.

Lihat juga

• PageSettingsConfig.collapseDiv
• SlotSettingsConfig.collapseDiv

---

InterstitialTrigger

InterstitialTrigger: "unhideWindow" | "navBar" | "inactivity" | "endOfArticle" | "continueReading" | "backward"

Pemicu iklan interstisial yang didukung.

Catatan: Mulai 15 Juni 2026, pemicu backward tidak akan lagi didukung dan mengaktifkannya tidak akan berpengaruh. Lihat catatan rilis GPT untuk mengetahui informasi selengkapnya.

---

PrivacyTreatment

PrivacyTreatment: "disablePersonalization"

Perlakuan privasi penayang yang didukung.

---

Taksonomi

Taxonomy: "IAB_AUDIENCE_1_1" | "IAB_CONTENT_2_2"

Taksonomi yang didukung untuk sinyal yang diberikan penayang (PPS).

Lihat juga

• Taksonomi Audiens IAB 1.1
• Taksonomi Konten IAB 2.2

---

googletag.config.AdExpansionConfig

Setelan untuk mengontrol perluasan iklan.

Properti
enabled?	Apakah perluasan iklan diaktifkan atau dinonaktifkan.

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

Properti

---

Optional diaktifkan

enabled?: boolean

Apakah perluasan iklan diaktifkan atau dinonaktifkan.

Menetapkan nilai ini akan mengganti setelan default yang dikonfigurasi di Google Ad Manager.

Lihat juga

• Memperluas iklan di desktop dan tablet
• Memperluas iklan di web seluler (layar sebagian)

---

googletag.config.AdSenseAttributesConfig

Setelan untuk mengontrol perilaku iklan AdSense.

Atribut ini dapat digunakan untuk mengganti setelan sisi server berdasarkan permintaan.

Properti
adsense_ad_format?	Format iklan AdSense.
adsense_channel_ids?	ID channel AdSense.
adsense_test_mode?	Apakah mode pengujian diaktifkan atau tidak.
document_language?	Bahasa halaman tempat iklan ditampilkan.
page_url?	URL halaman tempat iklan ditampilkan.

Lihat juga

• PageSettingsConfig.adsenseAttributes
• SlotSettingsConfig.adsenseAttributes

Properti

---

Optional adsense_ad_format

adsense_ad_format?: "120x240_as" | "120x600_as" | "125x125_as" | "160x600_as" | "180x150_as" | "200x200_as" | "234x60_as" | "250x250_as" | "300x250_as" | "336x280_as" | "468x60_as" | "728x90_as"

Format iklan AdSense.

---

Optional adsense_channel_ids

adsense_channel_ids?: string

ID channel AdSense.

Nilai yang diizinkan adalah ID channel yang dipisahkan dengan '+'.

Contoh: 271828183+314159265

Lihat juga

• Melacak performa unit iklan dengan saluran khusus

---

Optional adsense_test_mode

adsense_test_mode?: "on"

Apakah mode pengujian diaktifkan atau tidak.

Jika ditetapkan ke on, iklan akan ditandai sebagai khusus pengujian, dan tidak akan disertakan dalam penghitungan atau penagihan. Setelan ini tidak boleh disetel untuk traffic produksi non-pengujian.

---

Optional document_language

document_language?: string

Bahasa halaman tempat iklan ditampilkan.

Nilai yang diizinkan adalah kode bahasa ISO 639-1 yang valid.

Contoh: en

Lihat juga

• Daftar kode bahasa ISO 639

---

Optional page_url

page_url?: string

URL halaman tempat iklan ditampilkan.

Nilai yang diizinkan adalah URL yang valid.

Contoh: http://www.example.com

---

googletag.config.AutoRefreshConfig

Setelan konfigurasi refresh otomatis.

Properti
backForwardCache?	Apakah GPT akan otomatis memuat ulang slot iklan yang dilihat secara aktif saat halaman dipulihkan dari back-forward cache.
heavyAds?	Apakah GPT akan otomatis memuat ulang slot iklan jika Intervensi Iklan Berat Chrome dipicu di iframe iklan slot.

Properti

---

Optional backForwardCache

backForwardCache?: boolean

Apakah GPT akan otomatis memuat ulang slot iklan yang dilihat secara aktif saat halaman dipulihkan dari back-forward cache. Nilai defaultnya adalah true.

Contoh

JavaScript

// Set the auto refresh configuration, disabling auto refresh on
// back/forward cache restore.
googletag.setConfig({ autoRefresh: { backForwardCache: false } });

// Clear the auto refresh configuration, restoring to default behavior.
googletag.setConfig({ autoRefresh: null });

JavaScript (lama)

// Set the auto refresh configuration, disabling auto refresh on
// back/forward cache restore.
googletag.setConfig({ autoRefresh: { backForwardCache: false } });

// Clear the auto refresh configuration, restoring to default behavior.
googletag.setConfig({ autoRefresh: null });

TypeScript

// Set the auto refresh configuration, disabling auto refresh on
// back/forward cache restore.
googletag.setConfig({ autoRefresh: { backForwardCache: false } });

// Clear the auto refresh configuration, restoring to default behavior.
googletag.setConfig({ autoRefresh: null });

Lihat juga

• Back/forward cache

---

Optional heavyAds

heavyAds?: boolean

Apakah GPT akan otomatis memuat ulang slot iklan jika Intervensi Iklan Berat Chrome dipicu di iframe iklan slot. Nilai defaultnya adalah true.

Contoh

JavaScript

// Set the auto refresh configuration, disabling auto refresh on heavy
// ad intervention.
googletag.setConfig({ autoRefresh: { heavyAds: false } });

// Clear the auto refresh configuration, restoring to default behavior.
googletag.setConfig({ autoRefresh: null });

JavaScript (lama)

// Set the auto refresh configuration, disabling auto refresh on heavy
// ad intervention.
googletag.setConfig({ autoRefresh: { heavyAds: false } });

// Clear the auto refresh configuration, restoring to default behavior.
googletag.setConfig({ autoRefresh: null });

TypeScript

// Set the auto refresh configuration, disabling auto refresh on heavy
// ad intervention.
googletag.setConfig({ autoRefresh: { heavyAds: false } });

// Clear the auto refresh configuration, restoring to default behavior.
googletag.setConfig({ autoRefresh: null });

Lihat juga

• Memahami Intervensi Iklan Berat Chrome

---

googletag.config.ContinueButtonConfig

Setelan untuk mengonfigurasi perilaku tombol lanjutkan.

Properti
backgroundColor?	Warna latar belakang tombol.
font?	Jenis font teks tombol.
fontColor?	Warna teks tombol.
freqCapIntervalMinutes?	Interval pembatasan frekuensi dalam menit.
targetId?	ID elemen HTML tempat tombol lanjutkan akan dirender/dipicu.

Lihat juga

• SlotSettingsConfig.continueButton

Properti

---

Optional backgroundColor

backgroundColor?: string

Warna latar belakang tombol.

Contoh: 'blue', '#94B1FF'

---

Optional font

font?: string

Jenis font teks tombol.

Contoh: 'Arial'

---

Optional fontColor

fontColor?: string

Warna teks tombol.

Contoh: 'white', '#B73B87'

---

Optional freqCapIntervalMinutes

freqCapIntervalMinutes?: number

Interval pembatasan frekuensi dalam menit.

Harus berupa bilangan bulat yang lebih besar dari atau sama dengan 1.

---

Optional targetId

targetId?: string

ID elemen HTML tempat tombol lanjutkan akan dirender/dipicu.

---

googletag.config.InterstitialConfig

Objek yang menentukan perilaku satu slot iklan interstisial.

Properti
requireStorageAccess?	Apakah izin penyimpanan lokal diperlukan untuk menampilkan iklan interstisial ini.
triggers?	Konfigurasi pemicu interstisial untuk iklan interstisial ini.

Properti

---

Optional requireStorageAccess

requireStorageAccess?: boolean

Apakah izin penyimpanan lokal diperlukan untuk menampilkan iklan interstisial ini.

GPT menggunakan penyimpanan lokal untuk menerapkan pembatasan frekuensi untuk iklan interstisial. Namun, pengguna yang belum memberikan izin penyimpanan lokal masih memenuhi syarat untuk ditayangkan iklan interstisial. Menetapkan properti ini ke true akan menonaktifkan perilaku default, dan memastikan iklan interstisial hanya ditampilkan kepada pengguna yang telah memberikan izin penyimpanan lokal.

Contoh

JavaScript

// Opt out of showing interstitials to users
// without local storage consent.
const interstitialSlot = googletag.defineOutOfPageSlot(
  "/1234567/sports",
  googletag.enums.OutOfPageFormat.INTERSTITIAL,
);

interstitialSlot.setConfig({
  interstitial: {
    requireStorageAccess: true, // defaults to false
  },
});

JavaScript (lama)

// Opt out of showing interstitials to users
// without local storage consent.
var interstitialSlot = googletag.defineOutOfPageSlot(
  "/1234567/sports",
  googletag.enums.OutOfPageFormat.INTERSTITIAL,
);

interstitialSlot.setConfig({
  interstitial: {
    requireStorageAccess: true, // defaults to false
  },
});

TypeScript

// Opt out of showing interstitials to users
// without local storage consent.
const interstitialSlot = googletag.defineOutOfPageSlot(
  "/1234567/sports",
  googletag.enums.OutOfPageFormat.INTERSTITIAL,
)!;

interstitialSlot.setConfig({
  interstitial: {
    requireStorageAccess: true, // defaults to false
  },
});

Lihat juga

• Memproses interstisial web

---

Optional pemicu

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

Konfigurasi pemicu interstisial untuk iklan interstisial ini.

Menetapkan nilai pemicu interstisial ke true akan mengaktifkannya dan false akan menonaktifkannya. Tindakan ini akan mengganti nilai default yang dikonfigurasi di Google Ad Manager.

Contoh

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

JavaScript (lama)

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

Lihat juga

• Menampilkan iklan interstisial web

---

googletag.config.LazyLoadConfig

Setelan untuk mengontrol penggunaan pemuatan lambat di GPT.

Properti
fetchMarginPercent?	Jarak minimum dari area pandang saat ini yang harus dimiliki slot sebelum kami meminta iklan, yang dinyatakan sebagai persentase ukuran area pandang.
mobileScaling?	Pengganda yang diterapkan ke margin di perangkat seluler.
renderMarginPercent?	Jarak minimum dari area pandang saat ini yang harus dimiliki slot sebelum kami merender iklan, yang dinyatakan sebagai persentase ukuran area pandang.

Lihat juga

• PageSettingsConfig.lazyLoad

Properti

---

Optional fetchMarginPercent

fetchMarginPercent?: number

Jarak minimum slot dari area pandang saat ini sebelum kami meminta iklan, yang dinyatakan sebagai persentase ukuran area pandang.

Jika digunakan bersama dengan renderMarginPercent, setelan ini memungkinkan pengambilan iklan di awal, tetapi menunggu untuk merender dan mendownload sub-resource lainnya. Oleh karena itu, nilai ini harus selalu lebih besar dari atau sama dengan renderMarginPercent.

Nilai 0 berarti "saat slot memasuki area pandang", 100 berarti "saat iklan berjarak 1 area pandang", dan seterusnya.

---

Optional mobileScaling

mobileScaling?: number

Pengganda yang diterapkan ke margin di perangkat seluler. Pengganda ini diterapkan ke fetchMarginPercent dan renderMarginPercent.

Hal ini memungkinkan margin yang berbeda di perangkat seluler vs. desktop, yang mungkin memiliki ukuran area pandang dan kecepatan scroll yang berbeda. Misalnya, nilai 2,0 akan mengalikan semua margin dengan 2 di perangkat seluler, sehingga meningkatkan jarak minimum yang dapat dimiliki slot dari area pandang sebelum pengambilan dan rendering.

---

Optional renderMarginPercent

renderMarginPercent?: number

Jarak minimum dari area pandang saat ini yang harus dimiliki slot sebelum kami merender iklan, yang dinyatakan sebagai persentase ukuran area pandang.

Jika digunakan bersama dengan fetchMarginPercent, setelan ini memungkinkan pengambilan data iklan terlebih dahulu, tetapi menunggu untuk merender dan mendownload subresource lainnya. Oleh karena itu, nilai ini harus selalu kurang dari atau sama dengan fetchMarginPercent.

Nilai 0 berarti "saat slot memasuki area pandang", 100 berarti "saat iklan berjarak 1 area pandang", dan seterusnya.

---

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 kumpulan fitur, lihat kolom dalam jenis PageSettingsConfig di bawah.

Contoh:

• Hanya fitur yang ditentukan dalam panggilan googletag.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 googletag.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 untuk 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,
    });

Properti
adExpansion?	Setelan untuk mengontrol perluasan iklan.
adsenseAttributes?	Setelan untuk mengonfigurasi atribut AdSense.
adYield?	Tidak digunakan lagi.
autoRefresh?	Setelan untuk mengonfigurasi perilaku pemuatan ulang iklan otomatis.
categoryExclusion?	Setelan untuk mengonfigurasi pengecualian kategori iklan.
centering?	Setelan untuk mengontrol pemusatan iklan secara horizontal.
collapseDiv?	Setelan untuk mengontrol perilaku penciutan slot iklan.
disableInitialLoad?	Setelan untuk mengontrol kapan iklan diminta.
lazyLoad?	Setelan untuk mengontrol penggunaan pemuatan lambat di GPT.
location?	Setelan untuk menargetkan item baris secara geografis ke lokasi geografis.
pps?	Setelan untuk mengontrol sinyal yang diberikan penayang (PPS).
privacyTreatments?	Setelan untuk mengontrol perlakuan privasi penayang.
requestHookTimeoutMs?	Setelan untuk mengontrol waktu maksimum GPT akan menunggu semua hook permintaan yang terdaftar selesai sebelum melanjutkan dengan panggilan iklan.
safeFrame?	Setelan untuk mengontrol penggunaan SafeFrame di GPT.
singleRequest?	Setelan untuk mengaktifkan atau menonaktifkan Arsitektur Permintaan Tunggal (SRA).
targeting?	Setelan untuk mengontrol penargetan nilai kunci.
threadYield?	Setelan untuk mengontrol apakah GPT harus menghasilkan thread JS saat meminta dan merender materi iklan.
videoAds?	Setelan untuk mengontrol iklan video.

Properti

---

Optional adExpansion

adExpansion?: AdExpansionConfig

Setelan untuk mengontrol perluasan iklan.

---

Optional adsenseAttributes

adsenseAttributes?: AdSenseAttributesConfig

Setelan untuk mengonfigurasi atribut AdSense.

Atribut AdSense yang dikonfigurasi melalui setelan ini akan berlaku untuk semua slot iklan di halaman. Setelan ini dapat dipanggil beberapa kali untuk menentukan beberapa nilai atribut, atau menimpa nilai yang ada.

Perubahan atribut AdSense hanya berlaku untuk iklan yang diminta setelah metode ini dipanggil. Oleh karena itu, sebaiknya panggil metode ini sebelum panggilan apa pun ke googletag.display atau PubAdsService.refresh.

Contoh

JavaScript

// Set the document language and page URL.
googletag.setConfig({
  adsenseAttributes: { document_language: "en", page_url: "http://www.example.com" },
});

// Clear the page URL only.
googletag.setConfig({ adsenseAttributes: { page_url: null } });

// Clear all AdSense attributes.
googletag.setConfig({ adsenseAttributes: null });

JavaScript (lama)

// Set the document language and page URL.
googletag.setConfig({
  adsenseAttributes: { document_language: "en", page_url: "http://www.example.com" },
});

// Clear the page URL only.
googletag.setConfig({ adsenseAttributes: { page_url: null } });

// Clear all AdSense attributes.
googletag.setConfig({ adsenseAttributes: null });

TypeScript

// Set the document language and page URL.
googletag.setConfig({
  adsenseAttributes: { document_language: "en", page_url: "http://www.example.com" },
});

// Clear the page URL only.
googletag.setConfig({ adsenseAttributes: { page_url: null } });

// Clear all AdSense attributes.
googletag.setConfig({ adsenseAttributes: null });

---

Optional adYield

adYield?: "DISABLED" | "ENABLED_ALL_SLOTS"

Tidak digunakan lagi: Gunakan threadYield sebagai gantinya. Fitur ini akan dihapus dalam waktu dekat.

---

Optional autoRefresh

autoRefresh?: AutoRefreshConfig

Setelan untuk mengonfigurasi perilaku pemuatan ulang iklan otomatis.

Contoh

JavaScript

// Set the auto refresh configuration.
googletag.setConfig({ autoRefresh: { heavyAds: false } });

// Clear the auto refresh configuration.
googletag.setConfig({ autoRefresh: null });

JavaScript (lama)

// Set the auto refresh configuration.
googletag.setConfig({ autoRefresh: { heavyAds: false } });

// Clear the auto refresh configuration.
googletag.setConfig({ autoRefresh: null });

TypeScript

// Set the auto refresh configuration.
googletag.setConfig({ autoRefresh: { heavyAds: false } });

// Clear the auto refresh configuration.
googletag.setConfig({ autoRefresh: null });

---

Optional categoryExclusion

categoryExclusion?: string[]

Setelan untuk mengonfigurasi pengecualian kategori iklan.

Contoh

JavaScript

// Label = AirlineAd.
googletag.setConfig({ categoryExclusion: ["AirlineAd"] });

// Clearing category exclusion setting.
googletag.setConfig({ categoryExclusion: null });

JavaScript (lama)

// Label = AirlineAd.
googletag.setConfig({ categoryExclusion: ["AirlineAd"] });

// Clearing category exclusion setting.
googletag.setConfig({ categoryExclusion: null });

TypeScript

// Label = AirlineAd.
googletag.setConfig({ categoryExclusion: ["AirlineAd"] });

// Clearing category exclusion setting.
googletag.setConfig({ categoryExclusion: null });

Lihat juga

• Label khusus untuk memblokir iklan

---

Optional pemusatan

centering?: boolean

Setelan untuk mengontrol pemusatan iklan secara horizontal. Pemusatan dinonaktifkan secara default.

Perubahan pemusatan horizontal hanya berlaku untuk iklan yang diminta setelah metode ini dipanggil. Oleh karena itu, sebaiknya panggil metode ini sebelum panggilan apa pun ke googletag.display atau PubAdsService.refresh.

Contoh

JavaScript

// Make ads centered.
googletag.setConfig({ centering: true });

// Clear the centering setting.
googletag.setConfig({ centering: null });

JavaScript (lama)

// Make ads centered.
googletag.setConfig({ centering: true });

// Clear the centering setting.
googletag.setConfig({ centering: null });

TypeScript

// Make ads centered.
googletag.setConfig({ centering: true });

// Clear the centering setting.
googletag.setConfig({ centering: null });

---

Optional collapseDiv

collapseDiv?: CollapseDivBehavior

Setelan untuk mengontrol perilaku penciutan slot iklan.

Slot iklan yang diciutkan tidak menggunakan ruang apa pun di halaman.

Nilai yang didukung:

• null (default): Slot tidak akan diciutkan.
• DISABLED: Slot tidak akan diciutkan, baik iklan ditampilkan maupun tidak.
• BEFORE_FETCH: Slot akan dimulai dalam keadaan diciutkan, dan diperluas saat iklan ditampilkan.
• ON_NO_FILL: Slot akan dimulai dalam keadaan diperluas, dan diciutkan jika tidak ada iklan yang ditampilkan.

Contoh

JavaScript

// Collapse the div for this slot if no ad is returned.
googletag.setConfig({ collapseDiv: "ON_NO_FILL" });

// Collapse the div for this slot by default, and expand only
// if an ad is returned.
googletag.setConfig({ collapseDiv: "BEFORE_FETCH" });

// Do not collapse the div for this slot.
googletag.setConfig({ collapseDiv: "DISABLED" });

// Clear the collapse setting.
googletag.setConfig({ collapseDiv: null });

JavaScript (lama)

// Collapse the div for this slot if no ad is returned.
googletag.setConfig({ collapseDiv: "ON_NO_FILL" });

// Collapse the div for this slot by default, and expand only
// if an ad is returned.
googletag.setConfig({ collapseDiv: "BEFORE_FETCH" });

// Do not collapse the div for this slot.
googletag.setConfig({ collapseDiv: "DISABLED" });

// Clear the collapse setting.
googletag.setConfig({ collapseDiv: null });

TypeScript

// Collapse the div for this slot if no ad is returned.
googletag.setConfig({ collapseDiv: "ON_NO_FILL" });

// Collapse the div for this slot by default, and expand only
// if an ad is returned.
googletag.setConfig({ collapseDiv: "BEFORE_FETCH" });

// Do not collapse the div for this slot.
googletag.setConfig({ collapseDiv: "DISABLED" });

// Clear the collapse setting.
googletag.setConfig({ collapseDiv: null });

Lihat juga

• Menciutkan slot iklan kosong
• Meminimalkan pergeseran tata letak

---

Optional disableInitialLoad

disableInitialLoad?: boolean

Setelan untuk mengontrol kapan iklan diminta.

Secara default, metode googletag.display mendaftarkan slot iklan dan meminta iklan untuk slot tersebut. Namun, terkadang sebaiknya pisahkan tindakan ini, agar dapat mengontrol dengan lebih tepat kapan konten iklan dimuat.

Dengan mengaktifkan setelan ini, iklan tidak akan diminta untuk slot terdaftar saat metode display() dipanggil. Sebagai gantinya, panggilan terpisah ke PubAdsService.refresh harus dilakukan untuk memulai permintaan iklan.

Metode ini harus dipanggil sebelum memanggil googletag.enableServices.

Contoh

JavaScript

// Prevent requesting ads when `display()` is called.
googletag.setConfig({ disableInitialLoad: true });

JavaScript (lama)

// Prevent requesting ads when `display()` is called.
googletag.setConfig({ disableInitialLoad: true });

TypeScript

// Prevent requesting ads when `display()` is called.
googletag.setConfig({ disableInitialLoad: true });

Lihat juga

• Mengontrol pemuatan dan pemuatan ulang iklan
• Mengontrol pengelompokan SRA

---

Optional lazyLoad

lazyLoad?: LazyLoadConfig

Setelan untuk mengontrol penggunaan pemuatan lambat di GPT.

Pemuatan lambat adalah teknik untuk menunda permintaan dan rendering iklan hingga iklan mendekati area pandang pengguna. Untuk contoh yang lebih mendetail, lihat contoh Pemuatan lambat.

Catatan: Jika singleRequest diaktifkan, pengambilan lambat hanya akan berfungsi jika semua slot berada di luar margin pengambilan.

Setelan pemuatan lambat yang tidak ditentukan saat memanggil setConfig() akan menggunakan nilai default yang ditetapkan oleh Google. Setelan default ini dapat disesuaikan dari waktu ke waktu. Untuk menonaktifkan setelan tertentu, tetapkan nilai ke null.

Contoh

JavaScript

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

// Clear fetch margin only.
googletag.setConfig({
  lazyLoad: { fetchMarginPercent: null },
});

// Clear all lazy loading settings.
googletag.setConfig({ lazyLoad: null });

JavaScript (lama)

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

// Clear fetch margin only.
googletag.setConfig({
  lazyLoad: { fetchMarginPercent: null },
});

// Clear all lazy loading settings.
googletag.setConfig({ lazyLoad: null });

TypeScript

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

// Clear fetch margin only.
googletag.setConfig({
  lazyLoad: { fetchMarginPercent: null },
});

// Clear all lazy loading settings.
googletag.setConfig({ lazyLoad: null });

Lihat juga

• Praktik terbaik iklan: Prioritaskan slot iklan "penting"
• Pemuatan lambat

---

Optional lokasi

location?: string

Setelan untuk menargetkan item baris secara geografis ke lokasi geografis.

Contoh

JavaScript

// Geo-target line items to US postal code 10001.
googletag.setConfig({ location: "10001,US" });

// Clear the location setting.
googletag.setConfig({ location: null });

JavaScript (lama)

// Geo-target line items to US postal code 10001.
googletag.setConfig({ location: "10001,US" });

// Clear the location setting.
googletag.setConfig({ location: null });

TypeScript

// Geo-target line items to US postal code 10001.
googletag.setConfig({ location: "10001,US" });

// Clear the location setting.
googletag.setConfig({ location: null });

Lihat juga

• Menargetkan lokasi geografis untuk penayangan

---

Optional pps

pps?: PublisherProvidedSignalsConfig

Setelan untuk mengontrol sinyal yang diberikan penayang (PPS).

---

Optional privacyTreatments

privacyTreatments?: PrivacyTreatmentsConfig

Setelan untuk mengontrol perlakuan privasi penayang.

---

Optional Experimental requestHookTimeoutMs

requestHookTimeoutMs?: number | "auto"

Setelan untuk mengontrol waktu maksimum GPT akan menunggu semua hook permintaan terdaftar selesai sebelum melanjutkan dengan panggilan iklan.

Semua hook permintaan terdaftar dijalankan secara paralel. Waktu tunggu ini menentukan batas atas durasi jeda proses permintaan iklan saat menunggu eksekusi paralel tersebut selesai.

Nilai yang didukung:

• Angka positif dalam milidetik: Periode tunggu yang disesuaikan.
• 'auto': GPT menggunakan waktu tunggu yang dioptimalkan Google.
• null: Menonaktifkan waktu tunggu (GPT menunggu hook selesai tanpa batas waktu).

Contoh

JavaScript

// Set a 1000ms timeout for request hooks.
googletag.setConfig({ requestHookTimeoutMs: 1000 });

// Use a Google-optimized timeout for request hooks.
googletag.setConfig({ requestHookTimeoutMs: "auto" });

// Clear the timeout.
googletag.setConfig({ requestHookTimeoutMs: null });

JavaScript (lama)

// Set a 1000ms timeout for request hooks.
googletag.setConfig({ requestHookTimeoutMs: 1000 });

// Use a Google-optimized timeout for request hooks.
googletag.setConfig({ requestHookTimeoutMs: "auto" });

// Clear the timeout.
googletag.setConfig({ requestHookTimeoutMs: null });

TypeScript

// Set a 1000ms timeout for request hooks.
googletag.setConfig({ requestHookTimeoutMs: 1000 });

// Use a Google-optimized timeout for request hooks.
googletag.setConfig({ requestHookTimeoutMs: "auto" });

// Clear the timeout.
googletag.setConfig({ requestHookTimeoutMs: null });

---

Optional safeFrame

safeFrame?: SafeFrameConfig

Setelan untuk mengontrol penggunaan SafeFrame di GPT.

Nilai yang dikonfigurasi melalui setelan ini akan berlaku untuk semua slot iklan di halaman. Slot iklan individual dapat mengganti nilai ini melalui SlotSettingsConfig.safeFrame.

Contoh

JavaScript

// Force SafeFrame for all ads on the page.
googletag.setConfig({
  safeFrame: { forceSafeFrame: true },
});

// Configure SafeFrame to allow overlay expansion.
googletag.setConfig({
  safeFrame: { allowOverlayExpansion: true },
});

// Clear forceSafeFrame setting.
googletag.setConfig({
  safeFrame: { forceSafeFrame: null },
});

// Clear all SafeFrame settings.
googletag.setConfig({ safeFrame: null });

JavaScript (lama)

// Force SafeFrame for all ads on the page.
googletag.setConfig({
  safeFrame: { forceSafeFrame: true },
});

// Configure SafeFrame to allow overlay expansion.
googletag.setConfig({
  safeFrame: { allowOverlayExpansion: true },
});

// Clear forceSafeFrame setting.
googletag.setConfig({
  safeFrame: { forceSafeFrame: null },
});

// Clear all SafeFrame settings.
googletag.setConfig({ safeFrame: null });

TypeScript

// Force SafeFrame for all ads on the page.
googletag.setConfig({
  safeFrame: { forceSafeFrame: true },
});

// Configure SafeFrame to allow overlay expansion.
googletag.setConfig({
  safeFrame: { allowOverlayExpansion: true },
});

// Clear forceSafeFrame setting.
googletag.setConfig({
  safeFrame: { forceSafeFrame: null },
});

// Clear all SafeFrame settings.
googletag.setConfig({ safeFrame: null });

---

Optional singleRequest

singleRequest?: boolean

Setelan untuk mengaktifkan atau menonaktifkan Arsitektur Permintaan Tunggal (SRA).

Jika SRA diaktifkan, semua slot iklan yang ditentukan sebelum panggilan googletag.display atau PubAdsService.refresh akan dikelompokkan ke dalam satu permintaan iklan. Hal ini memberikan manfaat performa, tetapi juga diperlukan untuk memastikan iklan roadblock dan pengecualian kompetitif dipatuhi.

Jika SRA dinonaktifkan, setiap slot iklan akan diminta satu per satu. Ini adalah perilaku default GPT.

Metode ini harus dipanggil sebelum memanggil googletag.enableServices.

Contoh

JavaScript

// Enable Single Request Architecture.
googletag.setConfig({ singleRequest: true });

JavaScript (lama)

// Enable Single Request Architecture.
googletag.setConfig({ singleRequest: true });

TypeScript

// Enable Single Request Architecture.
googletag.setConfig({ singleRequest: true });

Lihat juga

• Tentang iklan roadblock
• Praktik terbaik iklan: Menggunakan Arsitektur Permintaan Tunggal dengan benar
• Mengontrol pengelompokan SRA

---

Optional penargetan

targeting?: Record<string, string | string[]>

Setelan untuk mengontrol penargetan nilai kunci.

Penargetan yang dikonfigurasi melalui setelan ini akan berlaku untuk semua slot iklan di halaman. Setelan ini dapat dipanggil beberapa kali untuk menentukan beberapa nilai kunci penargetan, atau menimpa nilai yang ada. Kunci penargetan ditentukan di akun Google Ad Manager Anda.

Contoh

JavaScript

// Setting a single targeting key-value.
googletag.setConfig({ targeting: { interests: "sports" } });

// Setting multiple values for a single targeting key
googletag.setConfig({ targeting: { interests: ["sports", "music"] } });

// Setting multiple targeting key-values at once.
googletag.setConfig({ targeting: { interests: ["sports", "music"], color: "red" } });

// Clearing a single targeting key.
googletag.setConfig({ targeting: { interests: null } });

JavaScript (lama)

// Setting a single targeting key-value.
googletag.setConfig({ targeting: { interests: "sports" } });

// Setting multiple values for a single targeting key
googletag.setConfig({ targeting: { interests: ["sports", "music"] } });

// Setting multiple targeting key-values at once.
googletag.setConfig({ targeting: { interests: ["sports", "music"], color: "red" } });

// Clearing a single targeting key.
googletag.setConfig({ targeting: { interests: null } });

TypeScript

// Setting a single targeting key-value.
googletag.setConfig({ targeting: { interests: "sports" } });

// Setting multiple values for a single targeting key
googletag.setConfig({ targeting: { interests: ["sports", "music"] } });

// Setting multiple targeting key-values at once.
googletag.setConfig({ targeting: { interests: ["sports", "music"], color: "red" } });

// Clearing a single targeting key.
googletag.setConfig({ targeting: { interests: null } });

Lihat juga

• Penargetan nilai kunci

---

Optional threadYield

threadYield?: "DISABLED" | "ENABLED_ALL_SLOTS"

Setelan untuk mengontrol apakah GPT harus menghasilkan thread JS saat meminta dan merender materi iklan.

GPT hanya akan menghasilkan thread JS untuk browser yang mendukung API Scheduler.postTask atau Scheduler.yield.

Nilai yang didukung:

• null (default): GPT akan menghasilkan thread JS untuk slot di luar area pandang.
• ENABLED_ALL_SLOTS: GPT akan menghasilkan thread JS untuk semua slot, terlepas dari apakah slot berada dalam area pandang atau tidak.
• DISABLED: GPT tidak akan menghasilkan thread JS.

Contoh

JavaScript

// Disable yielding.
googletag.setConfig({ threadYield: "DISABLED" });

// Enable yielding for all slots.
googletag.setConfig({ threadYield: "ENABLED_ALL_SLOTS" });

// Enable yielding only for slots outside of the viewport (default).
googletag.setConfig({ threadYield: null });

JavaScript (lama)

// Disable yielding.
googletag.setConfig({ threadYield: "DISABLED" });

// Enable yielding for all slots.
googletag.setConfig({ threadYield: "ENABLED_ALL_SLOTS" });

// Enable yielding only for slots outside of the viewport (default).
googletag.setConfig({ threadYield: null });

TypeScript

// Disable yielding.
googletag.setConfig({ threadYield: "DISABLED" });

// Enable yielding for all slots.
googletag.setConfig({ threadYield: "ENABLED_ALL_SLOTS" });

// Enable yielding only for slots outside of the viewport (default).
googletag.setConfig({ threadYield: null });

Lihat juga

• Scheduler

---

Optional videoAds

videoAds?: VideoAdsConfig

Setelan untuk mengontrol iklan video.

Contoh

JavaScript

// Enable video ads and set video content and content source IDs.
googletag.setConfig({
  videoAds: {
    enableVideoAds: true,
    videoContentId: "e1eGlRL7ju8",
    videoCmsId: "1234567",
  },
});

JavaScript (lama)

// Enable video ads and set video content and content source IDs.
googletag.setConfig({
  videoAds: {
    enableVideoAds: true,
    videoContentId: "e1eGlRL7ju8",
    videoCmsId: "1234567",
  },
});

TypeScript

// Enable video ads and set video content and content source IDs.
googletag.setConfig({
  videoAds: {
    enableVideoAds: true,
    videoContentId: "e1eGlRL7ju8",
    videoCmsId: "1234567",
  },
});

Lihat juga

• Penyerapan konten video

---

googletag.config.PrivacyTreatmentsConfig

Setelan untuk mengontrol perlakuan privasi penayang.

Properti
treatments	Array perlakuan privasi penayang yang akan diaktifkan.

Properti

---

perawatan

treatments: "disablePersonalization"[]

Array perlakuan privasi penayang yang akan diaktifkan.

Contoh

JavaScript

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

JavaScript (lama)

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

TypeScript

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

---

googletag.config.PublisherProvidedSignalsConfig

Objek konfigurasi sinyal yang diberikan penayang (PPS).

Properti
taxonomies	Objek yang berisi pemetaan Taksonomi atau null untuk menghapus konfigurasi.

Contoh

JavaScript

googletag.setConfig({
  pps: {
    taxonomies: {
      IAB_AUDIENCE_1_1: { values: ["6", "626"] },
      // '6' = 'Demographic | Age Range | 30-34'
      // '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 | 30-34'
      // '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 | 30-34'
      // '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

Properti

---

taksonomi

taxonomies: Partial<Record<Taxonomy, TaxonomyData>>

Objek yang berisi pemetaan Taksonomi atau null untuk menghapus konfigurasi.

---

googletag.config.SafeFrameConfig

Setelan untuk mengontrol SafeFrame di GPT.

Properti
allowOverlayExpansion?	Apakah SafeFrame harus mengizinkan konten iklan diperluas dengan menempatkan konten halaman di atasnya.
allowPushExpansion?	Apakah SafeFrame harus mengizinkan konten iklan diperluas dengan mendorong konten halaman.
forceSafeFrame?	Apakah iklan harus dipaksa untuk dirender menggunakan penampung SafeFrame.
sandbox?	Apakah SafeFrame harus menggunakan atribut sandbox HTML5 untuk mencegah navigasi tingkat atas tanpa interaksi pengguna.
useUniqueDomain?	Tidak digunakan lagi. Apakah SafeFrame harus menggunakan subdomain acak untuk materi iklan Reservasi.

Lihat juga

• PageSettingsConfig.safeFrame
• SlotSettingsConfig.safeFrame

Properti

---

Optional allowOverlayExpansion

allowOverlayExpansion?: boolean

Apakah SafeFrame harus mengizinkan konten iklan diperluas dengan menempatkan konten halaman di atasnya.

---

Optional allowPushExpansion

allowPushExpansion?: boolean

Apakah SafeFrame harus mengizinkan konten iklan diperluas dengan mendorong konten halaman.

---

Optional forceSafeFrame

forceSafeFrame?: boolean

Apakah iklan harus dipaksa untuk dirender menggunakan penampung SafeFrame.

---

Optional sandbox

sandbox?: boolean

Apakah SafeFrame harus menggunakan atribut sandbox HTML5 untuk mencegah navigasi tingkat atas tanpa interaksi pengguna. Satu-satunya nilai yang valid adalah true (tidak dapat dipaksa menjadi false). Perhatikan bahwa atribut sandbox menonaktifkan plugin (misalnya Flash).

---

Optional useUniqueDomain

useUniqueDomain?: boolean

Apakah SafeFrame harus menggunakan subdomain acak untuk materi iklan Reservasi. Teruskan null untuk menghapus nilai yang disimpan.

Catatan: fitur ini diaktifkan secara default.

Tidak digunakan lagi: Fitur ini tidak dapat lagi dinonaktifkan. Menetapkan useUniqueDomain tidak akan berpengaruh.

Lihat juga

• Merender materi iklan menggunakan SafeFrame

---

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 kumpulan fitur, lihat kolom dalam jenis SlotSettingsConfig di bawah.

Contoh:

• Hanya fitur yang ditentukan 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 untuk 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,
    });

Properti
adExpansion?	Setelan untuk mengonfigurasi perluasan iklan.
adsenseAttributes?	Setelan untuk mengonfigurasi atribut AdSense.
categoryExclusion?	Setelan untuk mengonfigurasi pengecualian kategori iklan.
clickUrl?	Setelan untuk mengonfigurasi URL yang akan menjadi tujuan pengalihan pengguna setelah mengklik iklan.
collapseDiv?	Setelan untuk mengonfigurasi perilaku penciutan slot iklan.
continueButton?	Setelan untuk mengonfigurasi perilaku tombol lanjutkan untuk iklan saat jeda konten.
interstitial?	Setelan yang mengonfigurasi perilaku slot iklan interstisial.
safeFrame?	Setelan untuk mengonfigurasi penggunaan SafeFrame di GPT.
targeting?	Setelan untuk mengonfigurasi penargetan nilai kunci.

Properti

---

Optional adExpansion

adExpansion?: AdExpansionConfig

Setelan untuk mengonfigurasi perluasan iklan.

Lihat juga

• Perluasan iklan

---

Optional adsenseAttributes

adsenseAttributes?: AdSenseAttributesConfig

Setelan untuk mengonfigurasi atribut AdSense.

Atribut AdSense yang dikonfigurasi melalui setelan ini hanya akan berlaku untuk slot iklan. Setelan ini dapat dipanggil beberapa kali untuk menentukan beberapa nilai atribut, atau menimpa nilai yang ada.

Perubahan atribut AdSense hanya berlaku untuk iklan yang diminta setelah metode ini dipanggil. Oleh karena itu, sebaiknya panggil metode ini sebelum panggilan apa pun ke googletag.display atau PubAdsService.refresh.

Contoh

JavaScript

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

// Set the AdSense ad format and channel IDs.
slot.setConfig({
  adsenseAttributes: {
    adsense_ad_format: "120x240_as",
    adsense_channel_ids: "271828183+314159265",
  },
});

// Clear the AdSense channel IDs only.
slot.setConfig({ adsenseAttributes: { adsense_channel_ids: null } });

// Clear all AdSense attributes.
slot.setConfig({ adsenseAttributes: null });

JavaScript (lama)

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

// Set the AdSense ad format and channel IDs.
slot.setConfig({
  adsenseAttributes: {
    adsense_ad_format: "120x240_as",
    adsense_channel_ids: "271828183+314159265",
  },
});

// Clear the AdSense channel IDs only.
slot.setConfig({ adsenseAttributes: { adsense_channel_ids: null } });

// Clear all AdSense attributes.
slot.setConfig({ adsenseAttributes: null });

TypeScript

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

// Set the AdSense ad format and channel IDs.
slot.setConfig({
  adsenseAttributes: {
    adsense_ad_format: "120x240_as",
    adsense_channel_ids: "271828183+314159265",
  },
});

// Clear the AdSense channel IDs only.
slot.setConfig({ adsenseAttributes: { adsense_channel_ids: null } });

// Clear all AdSense attributes.
slot.setConfig({ adsenseAttributes: null });

---

Optional categoryExclusion

categoryExclusion?: string[]

Setelan untuk mengonfigurasi pengecualian kategori iklan.

Contoh

JavaScript

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

// Label = AirlineAd
slot.setConfig({
  categoryExclusion: ["AirlineAd"],
});

// Clearing category exclusion setting.
slot.setConfig({ categoryExclusion: null });

JavaScript (lama)

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

// Label = AirlineAd
slot.setConfig({
  categoryExclusion: ["AirlineAd"],
});

// Clearing category exclusion setting.
slot.setConfig({ categoryExclusion: null });

TypeScript

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

// Label = AirlineAd
slot.setConfig({
  categoryExclusion: ["AirlineAd"],
});

// Clearing category exclusion setting.
slot.setConfig({ categoryExclusion: null });

Lihat juga

• Label khusus untuk memblokir iklan

---

Optional clickUrl

clickUrl?: string

Setelan untuk mengonfigurasi URL yang akan menjadi tujuan pengalihan pengguna setelah mengklik iklan.

Server Google Ad Manager tetap mencatat klik meskipun URL klik diganti. URL halaman landing apa pun yang terkait dengan materi iklan yang ditayangkan akan ditambahkan ke nilai yang diberikan. Menetapkan nilai ini lebih dari sekali akan menimpa nilai yang dikonfigurasi sebelumnya. Meneruskan null akan menghapus nilai.

Catatan: Setelan ini hanya berlaku untuk permintaan non-SRA.

Contoh

JavaScript

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

// Sets the click URL to 'http://www.example.com?original_click_url='.
slot.setConfig({
  clickUrl: "http://www.example.com?original_click_url=",
});

// Clears the click URL.
slot.setConfig({
  clickUrl: null,
});

JavaScript (lama)

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

// Sets the click URL to 'http://www.example.com?original_click_url='.
slot.setConfig({
  clickUrl: "http://www.example.com?original_click_url=",
});

// Clears the click URL.
slot.setConfig({
  clickUrl: null,
});

TypeScript

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

// Sets the click URL to 'http://www.example.com?original_click_url='.
slot.setConfig({
  clickUrl: "http://www.example.com?original_click_url=",
});

// Clears the click URL.
slot.setConfig({
  clickUrl: null,
});

---

Optional collapseDiv

collapseDiv?: CollapseDivBehavior

Setelan untuk mengonfigurasi perilaku penciutan slot iklan.

Slot iklan yang diciutkan tidak menggunakan ruang apa pun di halaman.

Nilai yang didukung:

• null (default): Slot tidak akan diciutkan.
• DISABLED: Slot tidak akan diciutkan, baik iklan ditampilkan maupun tidak.
• BEFORE_FETCH: Slot akan dimulai dalam keadaan diciutkan, dan diperluas saat iklan ditampilkan.
• ON_NO_FILL: Slot akan dimulai dalam keadaan diperluas, dan diciutkan jika tidak ada iklan yang ditampilkan.

Contoh

JavaScript

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

// Collapse the div for this slot if no ad is returned.
slot.setConfig({
  collapseDiv: "ON_NO_FILL",
});

// Collapse the div for this slot by default, and expand only
// if an ad is returned.
slot.setConfig({
  collapseDiv: "BEFORE_FETCH",
});

// Do not collapse the div for this slot.
slot.setConfig({
  collapseDiv: "DISABLED",
});

// Clear the collapse setting.
slot.setConfig({
  collapseDiv: null,
});

JavaScript (lama)

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

// Collapse the div for this slot if no ad is returned.
slot.setConfig({
  collapseDiv: "ON_NO_FILL",
});

// Collapse the div for this slot by default, and expand only
// if an ad is returned.
slot.setConfig({
  collapseDiv: "BEFORE_FETCH",
});

// Do not collapse the div for this slot.
slot.setConfig({
  collapseDiv: "DISABLED",
});

// Clear the collapse setting.
slot.setConfig({
  collapseDiv: null,
});

TypeScript

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

// Collapse the div for this slot if no ad is returned.
slot.setConfig({
  collapseDiv: "ON_NO_FILL",
});

// Collapse the div for this slot by default, and expand only
// if an ad is returned.
slot.setConfig({
  collapseDiv: "BEFORE_FETCH",
});

// Do not collapse the div for this slot.
slot.setConfig({
  collapseDiv: "DISABLED",
});

// Clear the collapse setting.
slot.setConfig({
  collapseDiv: null,
});

Lihat juga

• Menciutkan slot iklan kosong
• Meminimalkan pergeseran tata letak

---

Optional continueButton

continueButton?: ContinueButtonConfig

Setelan untuk mengonfigurasi perilaku tombol lanjutkan untuk iklan saat jeda konten.

Setelan ini memungkinkan penyesuaian tampilan dan perilaku interaksi keluar dan lanjutkan membaca yang terkait dengan format jeda konten.

Setelan tombol lanjutkan yang tidak ditentukan saat memanggil setConfig() akan menggunakan nilai default yang ditetapkan oleh Google.

Untuk menonaktifkan atau menghapus semua setelan tombol lanjutkan, teruskan null.

Contoh

JavaScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .addService(googletag.pubads());
// Configure continue button settings.
slot.setConfig({
  continueButton: {
    font: "Arial",
    fontColor: "white",
    backgroundColor: "blue",
    targetId: "target-div-id",
    freqCapIntervalMinutes: 20,
  },
});

// Clear continue button settings.
slot.setConfig({ continueButton: null });

JavaScript (lama)

var slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")
  .addService(googletag.pubads());
// Configure continue button settings.
slot.setConfig({
  continueButton: {
    font: "Arial",
    fontColor: "white",
    backgroundColor: "blue",
    targetId: "target-div-id",
    freqCapIntervalMinutes: 20,
  },
});

// Clear continue button settings.
slot.setConfig({ continueButton: null });

TypeScript

const slot = googletag
  .defineSlot("/1234567/sports", [160, 600], "div")!
  .addService(googletag.pubads());
// Configure continue button settings.
slot.setConfig({
  continueButton: {
    font: "Arial",
    fontColor: "white",
    backgroundColor: "blue",
    targetId: "target-div-id",
    freqCapIntervalMinutes: 20,
  },
});

// Clear continue button settings.
slot.setConfig({ continueButton: null });

---

Optional interstisial

interstitial?: InterstitialConfig

Setelan yang mengonfigurasi perilaku slot iklan interstisial.

Lihat juga

• Memproses interstisial web

---

Optional safeFrame

safeFrame?: SafeFrameConfig

Setelan untuk mengonfigurasi penggunaan SafeFrame di GPT.

Nilai yang dikonfigurasi melalui setelan ini hanya akan berlaku untuk slot iklan, dan mengganti nilai yang ditetapkan melalui PageSettingsConfig.safeFrame.

Contoh

JavaScript

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

// Force SafeFrame for the slot.
slot.setConfig({
  safeFrame: { forceSafeFrame: true },
});

// Configure SafeFrame to allow overlay expansion for the slot.
slot.setConfig({
  safeFrame: { allowOverlayExpansion: true },
});

// Clear forceSafeFrame setting for the slot.
slot.setConfig({
  safeFrame: { forceSafeFrame: null },
});

// Clear all SafeFrame settings for the slot.
slot.setConfig({ safeFrame: null });

JavaScript (lama)

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

// Force SafeFrame for the slot.
slot.setConfig({
  safeFrame: { forceSafeFrame: true },
});

// Configure SafeFrame to allow overlay expansion for the slot.
slot.setConfig({
  safeFrame: { allowOverlayExpansion: true },
});

// Clear forceSafeFrame setting for the slot.
slot.setConfig({
  safeFrame: { forceSafeFrame: null },
});

// Clear all SafeFrame settings for the slot.
slot.setConfig({ safeFrame: null });

TypeScript

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

// Force SafeFrame for the slot.
slot.setConfig({
  safeFrame: { forceSafeFrame: true },
});

// Configure SafeFrame to allow overlay expansion for the slot.
slot.setConfig({
  safeFrame: { allowOverlayExpansion: true },
});

// Clear forceSafeFrame setting for the slot.
slot.setConfig({
  safeFrame: { forceSafeFrame: null },
});

// Clear all SafeFrame settings for the slot.
slot.setConfig({ safeFrame: null });

---

Optional penargetan

targeting?: Record<string, string | string[]>

Setelan untuk mengonfigurasi penargetan nilai kunci.

Penargetan yang dikonfigurasi melalui setelan ini hanya akan berlaku untuk slot iklan. Setelan ini dapat dipanggil beberapa kali untuk menentukan beberapa nilai kunci penargetan, atau menimpa nilai yang ada. Kunci penargetan ditentukan di akun Google Ad Manager Anda.

Contoh

JavaScript

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

// Setting a single targeting key-value.
slot.setConfig({ targeting: { interests: "sports" } });

// Setting multiple values for a single targeting key.
slot.setConfig({ targeting: { interests: ["sports", "music"] } });

// Setting multiple targeting key-values at once.
slot.setConfig({ targeting: { interests: ["sports", "music"], color: "red" } });

// Clearing a single targeting key.
slot.setConfig({ targeting: { interests: null } });

// Clear all targeting keys.
slot.setConfig({ targeting: null });

JavaScript (lama)

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

// Setting a single targeting key-value.
slot.setConfig({ targeting: { interests: "sports" } });

// Setting multiple values for a single targeting key.
slot.setConfig({ targeting: { interests: ["sports", "music"] } });

// Setting multiple targeting key-values at once.
slot.setConfig({ targeting: { interests: ["sports", "music"], color: "red" } });

// Clearing a single targeting key.
slot.setConfig({ targeting: { interests: null } });

// Clear all targeting keys.
slot.setConfig({ targeting: null });

TypeScript

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

// Setting a single targeting key-value.
slot.setConfig({ targeting: { interests: "sports" } });

// Setting multiple values for a single targeting key.
slot.setConfig({ targeting: { interests: ["sports", "music"] } });

// Setting multiple targeting key-values at once.
slot.setConfig({ targeting: { interests: ["sports", "music"], color: "red" } });

// Clearing a single targeting key.
slot.setConfig({ targeting: { interests: null } });

// Clear all targeting keys.
slot.setConfig({ targeting: null });

Lihat juga

• Penargetan nilai kunci

---

googletag.config.TaxonomyData

Objek yang berisi nilai untuk satu Taksonomi.

Properti
values	Daftar nilai Taksonomi.

Properti

---

nilai

values: readonly string[]

Daftar nilai Taksonomi.

---

googletag.config.VideoAdsConfig

Setelan untuk mengonfigurasi setelan terkait iklan video.

Properti
enableVideoAds	Apakah iklan video akan ada di halaman.
videoCmsId?	ID sumber konten video.
videoContentId?	ID konten video.

Lihat juga

• PageSettingsConfig.videoAds

Properti

---

enableVideoAds

enableVideoAds: boolean

Apakah iklan video akan ada di halaman.

Jika ditetapkan ke true, setelan ini akan mengaktifkan batasan pengecualian konten pada iklan Display dan video.

Jika konten video diketahui, tetapkan videoContentId dan videoCmsId ke nilai yang diberikan ke layanan penyerapan konten Google Ad Manager untuk menggunakan pengecualian konten untuk iklan Display.

---

Optional videoCmsId

videoCmsId?: string

ID sumber konten video.

Ini adalah nilai unik yang ditetapkan oleh layanan penyerapan konten Google Ad Manager untuk mengidentifikasi sumber konten video yang ditentukan oleh videoContentId.

Lihat juga

• cmsid (ID Sumber Konten)

---

Optional videoContentId

videoContentId?: string

ID konten video.

Ini adalah nilai unik yang mengidentifikasi video tertentu dari sumber konten yang ditentukan oleh videoCmsId. Nilai ini ditetapkan oleh CMS yang menghosting konten video Anda.

Lihat juga

• vid (ID Video)

---

googletag.enums

Ini adalah namespace yang digunakan GPT untuk jenis enum.

Enumerasi
OutOfPageFormat	Format di luar halaman yang didukung oleh GPT.
TagForAgeTreatment	Setelan perlakuan berdasarkan usia yang didukung oleh GPT.
TrafficSource	Sumber traffic yang didukung oleh GPT.

Enumerasi

---

OutOfPageFormat

OutOfPageFormat

Format di luar halaman yang didukung oleh GPT.

Lihat juga

• defineOutOfPageSlot

Anggota Enumerasi
AD_INTENTS	Format Niat Iklan.
BOTTOM_ANCHOR	Format anchor dengan slot yang melekat di bagian bawah area pandang.
GAME_MANUAL_INTERSTITIAL	Format interstisial manual game. Catatan: Interstisial manual game adalah format dengan 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 yang melekat di bagian atas area pandang.

---

TagForAgeTreatment

TagForAgeTreatment

Setelan perlakuan berdasarkan usia yang didukung oleh GPT.

Lihat juga

• PrivacySettingsConfig.tagForAgeTreatment

Anggota Enumerasi
CHILD	Menunjukkan bahwa panggilan iklan akan menerima perlakuan usia ANAK.
TEEN	Menunjukkan bahwa panggilan iklan akan menerima perlakuan usia REMAJA.
UNSPECIFIED	Nilai default. Menunjukkan bahwa tidak ada sinyal perlakuan pembatasan usia tertentu yang berlaku untuk panggilan iklan.

---

TrafficSource

TrafficSource

Sumber traffic yang didukung oleh GPT.

Lihat juga

• PrivacySettingsConfig.trafficSource

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

---

googletag.events

Ini adalah namespace yang digunakan GPT untuk Peristiwa. Kode Anda dapat bereaksi terhadap peristiwa ini menggunakan Service.addEventListener.

Antarmuka
Event	Antarmuka Dasar untuk semua peristiwa GPT.
EventTypeMap	Ini adalah jenis semu yang memetakan nama peristiwa ke jenis objek peristiwa yang sesuai untuk Service.addEventListener dan Service.removeEventListener.
GameManualInterstitialSlotClosedEvent	Peristiwa ini diaktifkan saat slot interstisial manual game telah ditutup oleh pengguna.
GameManualInterstitialSlotReadyEvent	Peristiwa ini diaktifkan saat slot interstisial manual game siap ditampilkan kepada pengguna.
ImpressionViewableEvent	Peristiwa ini diaktifkan saat tayangan iklan terlihat, sesuai dengan kriteria Tampilan Aktif.
RewardedSlotClosedEvent	Peristiwa ini diaktifkan saat slot iklan reward ditutup oleh pengguna.
RewardedSlotGrantedEvent	Peristiwa ini diaktifkan saat reward diberikan karena melihat iklan reward.
RewardedSlotReadyEvent	Peristiwa ini diaktifkan saat iklan reward siap ditampilkan.
RewardedSlotVideoCompletedEvent	Peristiwa ini diaktifkan saat iklan video reward selesai diputar.
SlotOnloadEvent	Peristiwa ini diaktifkan saat iframe materi iklan mengaktifkan peristiwa pemuatannya.
SlotRenderEndedEvent	Peristiwa ini diaktifkan saat kode materi iklan dimasukkan ke dalam slot.
SlotRequestedEvent	Peristiwa ini diaktifkan saat iklan diminta untuk slot tertentu.
SlotResponseReceived	Peristiwa ini diaktifkan saat respons iklan telah diterima untuk slot tertentu.
SlotVisibilityChangedEvent	Peristiwa ini diaktifkan setiap kali persentase area slot iklan di layar berubah.

---

googletag.events.Event

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

Properti
serviceName	Nama layanan yang memicu peristiwa.
slot	Slot yang memicu peristiwa.

Lihat juga

• Pemroses peristiwa iklan

Properti

---

serviceName

serviceName: string

Nama layanan yang memicu peristiwa.

---

slot

slot: Slot

Slot yang memicu peristiwa.

---

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 keamanan jenis.

Properti
gameManualInterstitialSlotClosed	Alias untuk events.GameManualInterstitialSlotClosedEvent.
gameManualInterstitialSlotReady	Alias untuk events.GameManualInterstitialSlotReadyEvent.
impressionViewable	Alias untuk events.ImpressionViewableEvent.
rewardedSlotClosed	Alias untuk events.RewardedSlotClosedEvent.
rewardedSlotGranted	Alias untuk events.RewardedSlotGrantedEvent.
rewardedSlotReady	Alias untuk events.RewardedSlotReadyEvent.
rewardedSlotVideoCompleted	Alias untuk events.RewardedSlotVideoCompletedEvent.
slotOnload	Alias untuk events.SlotOnloadEvent.
slotRenderEnded	Alias untuk events.SlotRenderEndedEvent.
slotRequested	Alias untuk events.SlotRequestedEvent.
slotResponseReceived	Alias untuk events.SlotResponseReceived.
slotVisibilityChanged	Alias untuk events.SlotVisibilityChangedEvent.

Properti

---

gameManualInterstitialSlotClosed

gameManualInterstitialSlotClosed: GameManualInterstitialSlotClosedEvent

Alias untuk events.GameManualInterstitialSlotClosedEvent.

---

gameManualInterstitialSlotReady

gameManualInterstitialSlotReady: GameManualInterstitialSlotReadyEvent

Alias untuk events.GameManualInterstitialSlotReadyEvent.

---

impressionViewable

impressionViewable: ImpressionViewableEvent

Alias untuk events.ImpressionViewableEvent.

---

rewardedSlotClosed

rewardedSlotClosed: RewardedSlotClosedEvent

Alias untuk events.RewardedSlotClosedEvent.

---

rewardedSlotGranted

rewardedSlotGranted: RewardedSlotGrantedEvent

Alias untuk events.RewardedSlotGrantedEvent.

---

rewardedSlotReady

rewardedSlotReady: RewardedSlotReadyEvent

Alias untuk events.RewardedSlotReadyEvent.

---

rewardedSlotVideoCompleted

rewardedSlotVideoCompleted: RewardedSlotVideoCompletedEvent

Alias untuk events.RewardedSlotVideoCompletedEvent.

---

slotOnload

slotOnload: SlotOnloadEvent

Alias untuk events.SlotOnloadEvent.

---

slotRenderEnded

slotRenderEnded: SlotRenderEndedEvent

Alias untuk events.SlotRenderEndedEvent.

---

slotRequested

slotRequested: SlotRequestedEvent

Alias untuk events.SlotRequestedEvent.

---

slotResponseReceived

slotResponseReceived: SlotResponseReceived

Alias untuk events.SlotResponseReceived.

---

slotVisibilityChanged

slotVisibilityChanged: SlotVisibilityChangedEvent

Alias untuk events.SlotVisibilityChangedEvent.

---

googletag.events.GameManualInterstitialSlotClosedEvent

Memperluas Event

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

Catatan: Interstisial manual game adalah format dengan akses terbatas.

Properti
serviceName	Nama layanan yang memicu peristiwa. Diwarisi dari properti Event.serviceName
slot	Slot yang memicu peristiwa. Diwarisi dari properti Event.slot

Contoh

JavaScript

// This listener is called when a game manual interstitial slot is closed.
const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL,
);

// Slot returns null if the page or device does not support game manual interstitial ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  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 interstitial slot is closed.
var targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL,
);

// Slot returns null if the page or device does not support game manual interstitial ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  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 interstitial slot is closed.
const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.GAME_MANUAL_INTERSTITIAL,
);

// Slot returns null if the page or device does not support game manual interstitial ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  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

Memperluas Event

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

Catatan: Interstisial manual game adalah format dengan akses terbatas.

Properti
serviceName	Nama layanan yang memicu peristiwa. Diwarisi dari properti Event.serviceName
slot	Slot yang memicu peristiwa. Diwarisi dari properti Event.slot

Metode
makeGameManualInterstitialVisible	Menampilkan iklan interstisial manual game kepada pengguna.

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

// Slot returns null if the page or device does not support game manual interstitial ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

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

// Slot returns null if the page or device does not support game manual interstitial ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

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

// Slot returns null if the page or device does not support game manual interstitial ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  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

Metode

---

makeGameManualInterstitialVisible

makeGameManualInterstitialVisible(): boolean

Menampilkan iklan interstisial manual game kepada pengguna. Menampilkan apakah iklan berhasil ditampilkan.

Hasil
boolean

---

googletag.events.ImpressionViewableEvent

Memperluas Event

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

Properti
serviceName	Nama layanan yang memicu peristiwa. Diwarisi dari properti Event.serviceName
slot	Slot yang memicu peristiwa. Diwarisi dari properti Event.slot

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

Memperluas Event

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

Properti
serviceName	Nama layanan yang memicu peristiwa. Diwarisi dari properti Event.serviceName
slot	Slot yang memicu peristiwa. Diwarisi dari properti Event.slot

Contoh

JavaScript

const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.REWARDED,
);

// Slot returns null if the page or device does not support rewarded ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  // This listener is called when the user closes a rewarded ad slot.
  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)

var targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.REWARDED,
);

// Slot returns null if the page or device does not support rewarded ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  // This listener is called when the user closes a rewarded ad slot.
  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

const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.REWARDED,
);

// Slot returns null if the page or device does not support rewarded ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  // This listener is called when the user closes a rewarded ad slot.
  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

Memperluas Event

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

Properti
payload	Objek yang berisi informasi tentang reward yang diberikan.
serviceName	Nama layanan yang memicu peristiwa. Diwarisi dari properti Event.serviceName
slot	Slot yang memicu peristiwa. Diwarisi dari properti Event.slot

Contoh

JavaScript

const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.REWARDED,
);

// Slot returns null if the page or device does not support rewarded ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  // This listener is called whenever a reward is granted for a
  // rewarded ad.
  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)

var targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.REWARDED,
);

// Slot returns null if the page or device does not support rewarded ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  // This listener is called whenever a reward is granted for a
  // rewarded ad.
  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

const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.REWARDED,
);

// Slot returns null if the page or device does not support rewarded ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  // This listener is called whenever a reward is granted for a
  // rewarded ad.
  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

Properti

---

payload

payload: RewardedPayload

Objek yang berisi informasi tentang reward yang diberikan.

---

googletag.events.RewardedSlotReadyEvent

Memperluas Event

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

Properti
serviceName	Nama layanan yang memicu peristiwa. Diwarisi dari properti Event.serviceName
slot	Slot yang memicu peristiwa. Diwarisi dari properti Event.slot

Metode
makeRewardedVisible	Menampilkan iklan reward.

Contoh

JavaScript

// This listener is called when a rewarded ad slot becomes ready to be
// displayed.
const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.REWARDED,
);

// Slot returns null if the page or device does not support rewarded ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  // This listener is called whenever a reward is granted for a
  // rewarded ad.
  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.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.REWARDED,
);

// Slot returns null if the page or device does not support rewarded ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  // This listener is called whenever a reward is granted for a
  // rewarded ad.
  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.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.REWARDED,
);

// Slot returns null if the page or device does not support rewarded ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  // This listener is called whenever a reward is granted for a
  // rewarded ad.
  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

Metode

---

makeRewardedVisible

makeRewardedVisible(): boolean

Menampilkan iklan reward. Metode ini tidak boleh dipanggil hingga pengguna mengizinkan untuk melihat iklan.

Hasil
boolean	Apakah iklan reward berhasil ditampilkan.

---

googletag.events.RewardedSlotVideoCompletedEvent

Memperluas Event

Peristiwa ini diaktifkan saat iklan video reward selesai diputar.

Properti
serviceName	Nama layanan yang memicu peristiwa. Diwarisi dari properti Event.serviceName
slot	Slot yang memicu peristiwa. Diwarisi dari properti Event.slot

Contoh

JavaScript

const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.REWARDED,
);

// Slot returns null if the page or device does not support rewarded ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  // This listener is called when the video in a rewarded ad slot has
  // finished playing.
  googletag.pubads().addEventListener("rewardedSlotVideoCompleted", (event) => {
    const slot = event.slot;
    console.log("Video in rewarded ad slot", slot.getSlotElementId(), "has finished playing.");

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

JavaScript (lama)

var targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.REWARDED,
);

// Slot returns null if the page or device does not support rewarded ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  // This listener is called when the video in a rewarded ad slot has
  // finished playing.
  googletag.pubads().addEventListener("rewardedSlotVideoCompleted", function (event) {
    var slot = event.slot;
    console.log("Video in rewarded ad slot", slot.getSlotElementId(), "has finished playing.");

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

TypeScript

const targetSlot = googletag.defineOutOfPageSlot(
  "/1234567/example",
  googletag.enums.OutOfPageFormat.REWARDED,
);

// Slot returns null if the page or device does not support rewarded ads.
if (targetSlot) {
  targetSlot.addService(googletag.pubads());

  // This listener is called when the video in a rewarded ad slot has
  // finished playing.
  googletag.pubads().addEventListener("rewardedSlotVideoCompleted", (event) => {
    const slot = event.slot;
    console.log("Video in rewarded ad slot", slot.getSlotElementId(), "has finished playing.");

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

Lihat juga

• Pemroses peristiwa iklan
• Menampilkan iklan reward

---

googletag.events.SlotOnloadEvent

Memperluas Event

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

Properti
serviceName	Nama layanan yang memicu peristiwa. Diwarisi dari properti Event.serviceName
slot	Slot yang memicu peristiwa. Diwarisi dari properti Event.slot

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

Memperluas Event

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 selesai dimuat, pertimbangkan events.SlotOnloadEvent.

Properti
advertiserId	ID pengiklan dari iklan yang dirender.
campaignId	ID kampanye iklan yang dirender.
companyIds	ID perusahaan yang mengajukan bid pada iklan pengisian ulang yang dirender.
creativeId	ID materi iklan dari iklan reservasi yang dirender.
creativeTemplateId	ID template materi iklan dari iklan reservasi yang dirender.
isBackfill	Apakah iklan merupakan iklan pengisian ulang.
isEmpty	Apakah iklan ditampilkan untuk slot.
labelIds	Tidak digunakan lagi.
lineItemId	ID item baris iklan reservasi yang dirender.
responseIdentifier	ID respons adalah ID unik untuk respons iklan.
serviceName	Nama layanan yang memicu peristiwa. Diwarisi dari properti Event.serviceName
size	Menunjukkan ukuran piksel materi iklan yang dirender.
slot	Slot yang memicu peristiwa. Diwarisi dari properti Event.slot
slotContentChanged	Apakah konten slot diubah dengan iklan yang dirender.
sourceAgnosticCreativeId	ID materi iklan dari iklan reservasi atau pengisian ulang yang dirender.
sourceAgnosticLineItemId	ID item baris iklan reservasi atau pengisian ulang yang dirender.
yieldGroupIds	ID grup hasil untuk iklan pengisian ulang yang dirender.

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("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("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("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

Properti

---

advertiserId

advertiserId: number

ID pengiklan dari iklan yang dirender. Nilainya adalah null untuk slot kosong, iklan pengisian ulang, dan materi iklan yang dirender oleh layanan selain PubAdsService.

---

campaignId

campaignId: number

ID kampanye iklan yang dirender. Nilainya adalah null untuk slot kosong, iklan pengisian ulang, dan materi iklan yang dirender oleh layanan selain PubAdsService.

---

companyIds

companyIds: number[]

ID perusahaan yang mengajukan bid pada iklan pengisian ulang yang dirender. Nilainya adalah null untuk slot kosong, iklan reservasi, dan materi iklan yang dirender oleh layanan selain PubAdsService.

---

creativeId

creativeId: number

ID materi iklan dari iklan reservasi yang dirender. Nilainya adalah null untuk slot kosong, iklan pengisian ulang, dan materi iklan yang dirender oleh layanan selain PubAdsService.

---

creativeTemplateId

creativeTemplateId: number

ID template materi iklan dari iklan reservasi yang dirender. Nilainya adalah null untuk slot kosong, iklan pengisian ulang, dan materi iklan yang dirender oleh layanan selain PubAdsService.

---

isBackfill

isBackfill: boolean

Apakah iklan merupakan iklan pengisian ulang. Nilainya adalah true jika iklan tersebut adalah iklan pengisian ulang, dan false jika tidak.

---

isEmpty

isEmpty: boolean

Apakah iklan ditampilkan untuk slot. Nilainya adalah true jika tidak ada iklan yang ditampilkan, dan false jika sebaliknya.

---

labelIds

labelIds: number[]

Tidak digunakan lagi: Kolom ini tidak lagi diisi.

---

lineItemId

lineItemId: number

ID item baris iklan reservasi yang dirender. Nilainya adalah null untuk slot kosong, iklan pengisian ulang, dan materi iklan yang dirender oleh layanan selain PubAdsService.

---

responseIdentifier

responseIdentifier: string

ID respons adalah ID unik untuk respons iklan. Nilai ini dapat digunakan untuk mengidentifikasi dan memblokir iklan di Pusat Peninjauan Iklan (ARC).

---

size

size: string | number[]

Menunjukkan ukuran piksel materi iklan yang dirender. Contoh: [728, 90]. Nilainya adalah null untuk slot iklan kosong.

---

slotContentChanged

slotContentChanged: boolean

Apakah konten slot diubah dengan iklan yang dirender. Nilainya adalah true jika konten diubah, false jika tidak.

---

sourceAgnosticCreativeId

sourceAgnosticCreativeId: number

ID materi iklan dari iklan reservasi atau pengisian ulang yang dirender. Nilainya adalah null jika iklan bukan merupakan pengisian ulang reservasi atau item baris, atau materi iklan dirender oleh layanan selain PubAdsService.

---

sourceAgnosticLineItemId

sourceAgnosticLineItemId: number

ID item baris iklan reservasi atau pengisian ulang yang dirender. Nilainya adalah null jika iklan bukan merupakan pengisian ulang item baris atau reservasi, atau materi iklan dirender oleh layanan selain PubAdsService.

---

yieldGroupIds

yieldGroupIds: number[]

ID grup hasil untuk iklan pengisian ulang yang dirender. Nilainya adalah null untuk slot kosong, iklan reservasi, dan materi iklan yang dirender oleh layanan selain PubAdsService.

---

googletag.events.SlotRequestedEvent

Memperluas Event

Peristiwa ini diaktifkan saat iklan diminta untuk slot tertentu.

Properti
serviceName	Nama layanan yang memicu peristiwa. Diwarisi dari properti Event.serviceName
slot	Slot yang memicu peristiwa. Diwarisi dari properti Event.slot

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

Memperluas Event

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

Properti
serviceName	Nama layanan yang memicu peristiwa. Diwarisi dari properti Event.serviceName
slot	Slot yang memicu peristiwa. Diwarisi dari properti Event.slot

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

Memperluas Event

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

Properti
inViewPercentage	Persentase area iklan yang terlihat.
serviceName	Nama layanan yang memicu peristiwa. Diwarisi dari properti Event.serviceName
slot	Slot yang memicu peristiwa. Diwarisi dari properti Event.slot

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

Properti

---

inViewPercentage

inViewPercentage: number

Persentase area iklan yang terlihat. Nilai adalah angka antara 0 dan 100.

---

googletag.secureSignals

Ini adalah namespace yang digunakan GPT untuk mengelola sinyal aman.

Antarmuka
BidderSignalProvider	Menampilkan sinyal aman untuk bidder tertentu.
PublisherSignalProvider	Menampilkan sinyal aman untuk penayang tertentu.
SecureSignalProvidersArray	Antarmuka untuk mengelola sinyal aman.

Alias Jenis
SecureSignalProvider	Antarmuka untuk menampilkan sinyal aman bagi bidder atau penyedia tertentu.

Alias Jenis

---

SecureSignalProvider

SecureSignalProvider: BidderSignalProvider | PublisherSignalProvider

Antarmuka untuk menampilkan sinyal aman bagi bidder atau penyedia tertentu. Salah satu dari id atau networkCode harus diberikan, tetapi tidak keduanya.

---

googletag.secureSignals.BidderSignalProvider

Menampilkan sinyal aman untuk bidder tertentu.

Penyedia sinyal aman bidder terdiri dari 2 bagian:

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

Untuk menampilkan sinyal aman bagi penayang, gunakan secureSignals.PublisherSignalProvider.

Properti
collectorFunction	Fungsi yang menampilkan Promise yang di-resolve ke sinyal aman.
id	ID unik untuk pengumpul yang terkait dengan sinyal aman ini, seperti yang terdaftar di Google Ad Manager.

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

Properti

---

collectorFunction

collectorFunction: (() => Promise<string>)

Fungsi yang menampilkan Promise yang di-resolve ke sinyal aman.

---

id

id: string

ID unik untuk pengumpul yang terkait dengan sinyal aman ini, seperti yang terdaftar di Google Ad Manager.

---

googletag.secureSignals.PublisherSignalProvider

Menampilkan sinyal aman untuk penayang tertentu.

Penyedia sinyal penayang terdiri dari 2 bagian:

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

Untuk menampilkan sinyal aman bagi bidder, gunakan secureSignals.BidderSignalProvider.

Properti
collectorFunction	Fungsi yang menampilkan Promise yang di-resolve ke sinyal aman.
networkCode	Kode jaringan (seperti yang terlihat di jalur unit iklan) untuk penayang yang terkait dengan sinyal aman ini.

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

Properti

---

collectorFunction

collectorFunction: (() => Promise<string>)

Fungsi yang menampilkan Promise yang di-resolve ke sinyal aman.

---

networkCode

networkCode: string

Kode jaringan (seperti yang terlihat di jalur unit iklan) untuk penayang yang terkait dengan sinyal aman ini.

---

googletag.secureSignals.SecureSignalProvidersArray

Antarmuka untuk mengelola sinyal aman.

Metode
clearAllCache	Menghapus semua sinyal untuk semua pengumpul dari cache.
push	Menambahkan secureSignals.SecureSignalProvider baru ke array penyedia sinyal dan memulai proses pembuatan sinyal.

Metode

---

clearAllCache

clearAllCache(): void

Menghapus semua sinyal untuk semua pengumpul dari cache.

Memanggil metode ini dapat mengurangi kemungkinan sinyal disertakan dalam panggilan iklan untuk tayangan halaman saat ini dan kemungkinan di kemudian hari. Oleh karena itu, pemroses hanya boleh dipanggil saat terjadi perubahan status yang berarti, seperti peristiwa yang menunjukkan pengguna baru (login, logout, mendaftar, dll.).

---

push

push(provider: SecureSignalProvider): void

Menambahkan secureSignals.SecureSignalProvider baru ke array penyedia sinyal dan memulai proses pembuatan sinyal.

Parameter
provider: SecureSignalProvider	Objek secureSignals.SecureSignalProvider yang akan ditambahkan ke array.