Bu referansta, türleri açıklamak için TypeScript gösterimi kullanılmaktadır. Aşağıdaki tabloda örneklere göre kısa bir açıklama verilmiştir.
Tür ifadesi | |
---|---|
string |
Temel dize türü. |
string[] |
Değerlerin yalnızca dize olabildiği bir dizi türü. |
number | string |
Değerin bir sayı veya dize olabileceği bir birleştirme türü. |
Array<number | string> |
Değerlerin karmaşık (birleştirme) tür olduğu bir dizi türü. |
[number, string] |
Değerin, belirtilen sırada bir sayı ve dize içermesi gereken iki öğeli bir dizi olduğu tuple türü. |
Slot |
Değerin bir googletag.Slot örneği olduğu bir nesne türü. |
() => void |
Tanımlanmış bağımsız değişkeni ve dönüş değeri olmayan bir işlev türü. |
Desteklenen türler ve tür ifadeleri hakkında daha fazla bilgi edinmek için TypeScript El Kitabı 'na bakın.
Ek açıklamalar yazın
Değişken, parametre adı, özellik adı veya işlev imzasından sonra gelen iki nokta işareti bir tür ek açıklamasını belirtir. Tür ek açıklamaları, iki noktanın solundaki öğenin kabul edebileceği veya döndürebileceği türleri açıklar. Aşağıdaki tabloda, bu referansta görebileceğiniz ek açıklama türü örnekleri gösterilmektedir.
Ek açıklama türü | |
---|---|
param: string |
param işlevinin bir dize değeri kabul ettiğini veya döndürdüğünü belirtir. Bu söz dizimi değişkenler, parametreler, özellikler ve dönüş türleri için kullanılır.
|
param?: number | string |
param parametresinin isteğe bağlı olduğunu belirtir ancak belirtildiğinde bir sayı veya dize kabul eder. Bu söz dizimi, parametreler ve özellikler için kullanılır.
|
...params: Array<() => void> |
params parametresinin, işlevleri kabul eden bir
dinlenme parametresi
olduğunu belirtir. Geri kalan parametreler, belirtilen türde sınırsız sayıda değeri kabul eder.
|
Tür Tanımları
Türler | |
---|---|
|
SingleSize | MultiSize
|
Alan için bir veya daha fazla boyut olabilecek geçerli bir boyut yapılandırması. |
|
|
SingleSize[]
|
Geçerli tek bir boyutun listesi. |
|
|
"fluid" | ["fluid"]
|
Bir alanın sahip olabileceği adlandırılmış boyutlar. Çoğu durumda boyut, sabit boyutlu bir dikdörtgendir ancak başka tür boyut özelliklerine ihtiyaç duyduğumuz bazı durumlar da mevcuttur. Yalnızca aşağıdakiler geçerli adlandırılmış boyutlardır:
|
|
|
SingleSizeArray | NamedSize
|
Alan için tek bir geçerli boyut. |
|
|
[number, number]
|
[Genişlik, yükseklik] değerini temsil eden iki sayı dizisi. |
|
|
[SingleSizeArray, GeneralSize]
|
Görüntü alanı boyutunun reklam boyutlarıyla eşleştirilmesi. Duyarlı reklamlar için kullanılır. |
|
|
SizeMapping[]
|
Boyut eşlemeleri listesi. |
|
|
"unhideWindow" | "navBar"
|
Desteklenen geçiş reklamı tetikleyicileri. |
|
|
"disablePersonalization"
|
Desteklenen yayıncı gizlilik işlemleri. |
|
|
"IAB_AUDIENCE_1_1" | "IAB_CONTENT_2_2"
|
Yayıncı tarafından sağlanan sinyaller (PPS) için desteklenen sınıflandırmalar. |
|
|
BidderSignalProvider | PublisherSignalProvider
|
Belirli bir teklif veren veya sağlayıcı için güvenli sinyal döndürme arayüzü. |
Sıralama Türleri
Sıralamalar | |
---|---|
googletag.enums.OutOfPageFormat
|
GPT tarafından desteklenen sayfa dışı biçimler.
|
googletag.enums.TrafficSource
|
GPT tarafından desteklenen trafik kaynakları.
|
googletag.enums.OutOfPageFormat
-
GPT tarafından desteklenen sayfa dışı biçimler.
-
- Şunlara da bakabilirsiniz:
googletag.enums.TrafficSource
-
GPT tarafından desteklenen trafik kaynakları.
-
- Şunlara da bakabilirsiniz:
-
Değerler ORGANIC
Doğrudan URL girişi, site arama veya uygulama indirme.PURCHASED
Sahip olunanlar dışındaki mülklerden yönlendirilen trafik (edinilen veya başka bir şekilde teşvik edilen etkinlik).
googletag
Google Yayıncı Etiketi'nin kendi API'sı için kullandığı genel ad alanı.
Değişken Özeti | |
---|---|
apiReady
|
GPT API'nin yüklendiğini ve çağrılmaya hazır olduğunu gösteren işaret.
|
cmd
|
GPT ile ilgili çağrıların eşzamansız olarak yürütülmesi için genel komut kuyruğu referansı.
|
pubadsReady
|
PubAdsService hizmetinin etkin olduğunu, yüklendiğini ve tamamen çalışır durumda olduğunu gösteren işaret.
|
secureSignalProviders
|
Güvenli sinyal sağlayıcıları dizisine referans.
|
İşlev Özeti | |
---|---|
companionAds
|
CompanionAdsService öğesine bir başvuru döndürür.
|
defineOutOfPageSlot
|
Belirtilen reklam birimi yoluyla sayfa dışı bir reklam alanı oluşturur.
|
defineSlot
|
Belirli bir reklam birimi yolu ve boyutuyla bir reklam alanı oluşturur ve bunu, reklamı içeren sayfadaki bir div öğesinin kimliğiyle ilişkilendirir.
|
destroySlots
|
İlgili tüm nesneleri ve bu alanların referanslarını GPT'den kaldırarak belirtilen alanları kaldırır.
|
disablePublisherConsole
|
Google Yayıncı Konsolu'nu devre dışı bırakır.
|
display
|
Slot hizmetleri için alanı oluşturma talimatı verir.
|
enableServices
|
Sayfadaki reklam alanları için tanımlanmış tüm GPT hizmetlerini etkinleştirir.
|
getVersion
|
GPT'nin geçerli sürümünü döndürür.
|
openConsole
|
Google Yayıncı Konsolu'nu açar.
|
pubads
|
PubAdsService öğesine bir başvuru döndürür.
|
setAdIframeTitle
|
Bundan sonra
PubAdsService tarafından oluşturulan tüm reklam kapsayıcısı iframe'ler için başlığı ayarlar.
|
setConfig
|
Sayfa için genel yapılandırma seçeneklerini ayarlar.
|
sizeMapping
|
Yeni bir
SizeMappingBuilder oluşturur.
|
googletag.apiReady
-
apiReady: boolean | undefined
-
GPT API'nin yüklendiğini ve çağrılmaya hazır olduğunu gösteren işaret. API hazır olana kadar bu özellik sadece
undefined
olacaktır.
Zaman uyumsuzluğunu yönetmenin önerilen yönteminin, GPT hazır olduğunda geri çağırmaları sıraya almak için googletag.cmd'nin kullanılması olduğunu unutmayın. API kurulduktan sonra yürütüleceği garanti edilen bu geri çağırmaların googletag.apiReady'yi kontrol etmesi gerekmez. -
- Örnek
-
JavaScript
if (window.googletag && googletag.apiReady) { // GPT API can be called safely. }
JavaScript (eski)
if (window.googletag && googletag.apiReady) { // GPT API can be called safely. }
TypeScript
if (window.googletag && googletag.apiReady) { // GPT API can be called safely. }
googletag.cmd
-
cmd: Array<(this: typeof globalThis) => void> | CommandArray
-
GPT ile ilgili çağrıların eşzamansız olarak yürütülmesi için genel komut kuyruğu referansı.
googletag.cmd
değişkeni, sayfadaki GPT etiketi söz dizimi tarafından boş bir JavaScript dizisi olarak başlatılır.cmd.push
ise dizinin sonuna bir öğe ekleyen standartArray.push
yöntemidir. GPT JavaScript yüklenirken dizide arama yapar ve tüm işlevleri sırayla yürütür. Daha sonra komut dosyası,cmd
öğesini, kendisine geçirilen fonksiyon bağımsız değişkenini yürütmek için push yönteminin tanımlandığı birCommandArray
nesnesiyle değiştirir. Bu mekanizma, tarayıcının sayfayı oluşturmaya devam etmesine izin verirken, GPT'nin JavaScript'i eşzamansız olarak alarak algılanan gecikmeyi azaltmasına olanak tanır. -
- Örnek
-
JavaScript
googletag.cmd.push(() => { googletag.defineSlot("/1234567/sports", [160, 600]).addService(googletag.pubads()); });
JavaScript (eski)
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()); });
googletag.pubadsReady
-
pubadsReady: boolean | undefined
-
PubAdsService
hizmetinin etkin olduğunu, yüklendiğini ve tamamen çalışır durumda olduğunu gösteren işaret. Bu özellik,enableServices
çağrılıncaya vePubAdsService
yüklenip başlatılıncaya kadarundefined
olacaktır. -
googletag.secureSignalProviders
-
secureSignalProviders: SecureSignalProvider[] | SecureSignalProvidersArray | undefined
-
Güvenli sinyal sağlayıcıları dizisine referans.
Güvenli sinyal sağlayıcıları dizisi, bir dizi sinyal üreten işlevi kabul eder ve bunları sırayla çağırır. GPT yüklendikten sonra çağrılmak üzere sinyal üreten işlevleri sıraya almak için kullanılan standart bir dizinin yerini alması amaçlanmıştır. -
- Örnek
-
JavaScript
window.googletag = window.googletag || { cmd: [] }; googletag.secureSignalProviders = googletag.secureSignalProviders || []; googletag.secureSignalProviders.push({ id: "collector123", collectorFunction: () => { return Promise.resolve("signal"); }, });
JavaScript (eski)
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"); }, });
- Şunlara da bakabilirsiniz:
googletag.companionAds
-
companionAds(): CompanionAdsService
-
CompanionAdsService
öğesine bir başvuru döndürür. -
-
İlerlemeler CompanionAdsService
Tamamlayıcı Reklamlar hizmeti.
googletag.defineOutOfPageSlot
-
defineOutOfPageSlot(adUnitPath: string, div?: string | OutOfPageFormat): Slot | null
-
Belirtilen reklam birimi yoluyla bir sayfa dışı reklam alanı oluşturur.
Özel sayfa dışı reklamlar içindiv
, reklamı içerecek div öğesinin kimliğidir. Daha fazla ayrıntı için sayfa dışı reklam öğeleri ile ilgili makaleye bakın.
GPT tarafından yönetilen sayfa dışı reklamlar içindiv
, desteklenen bir OutOfPageFormat öğesidir. -
- Örnek
-
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 (eski)
// 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);
- Şunlara da bakabilirsiniz:
-
Parametreler adUnitPath: string
Ağ kodu ve reklam birimi koduyla tam reklam birimi yolu.div?: string | OutOfPageFormat
Bu reklam birimini veya OutOfPageFormat'ı içerecek div'in kimliği. -
İlerlemeler Slot | null
Yeni oluşturulan alan veya alan oluşturulamıyorsanull
.
googletag.defineSlot
-
defineSlot(adUnitPath: string, size: GeneralSize, div?: string): Slot | null
-
Belirli bir reklam birimi yolu ve boyutuyla bir reklam alanı oluşturur ve bunu, reklamı içeren sayfadaki bir div öğesinin kimliğiyle ilişkilendirir.
-
- Örnek
-
JavaScript
googletag.defineSlot("/1234567/sports", [728, 90], "div-1");
JavaScript (eski)
googletag.defineSlot("/1234567/sports", [728, 90], "div-1");
TypeScript
googletag.defineSlot("/1234567/sports", [728, 90], "div-1");
- Şunlara da bakabilirsiniz:
-
Parametreler adUnitPath: string
Ağ kodu ve birim koduyla tam reklam birimi yolu.size: GeneralSize
Eklenen alanın genişliği ve yüksekliği. Bu boyut, duyarlı boyut eşlemesi sağlanmazsa veya görüntü alanının boyutu eşlemede sağlanan en küçük boyuttan daha küçükse reklam isteğinde kullanılan boyuttur.div?: string
Bu reklam birimini içerecek div'in kimliği. -
İlerlemeler Slot | null
Yeni oluşturulan alan veya alan oluşturulamıyorsanull
.
googletag.destroySlots
-
destroySlots(slots?: Slot[]): boolean
-
İlgili tüm nesneleri ve bu alanların referanslarını GPT'den kaldırarak belirtilen alanları kaldırır. Bu API, geri verilen gösterim alanlarını ve tamamlayıcı alanları desteklemez.
Bir alanda bu API'nin çağrılması, reklamı temizler ve alan nesnesini GPT tarafından sağlanan dahili durumdan kaldırır. Slot nesnesinde daha fazla işlev çağırmak, tanımlanmamış davranışla sonuçlanır. Yayıncı sayfası tarafından bir referans sağlanması durumunda tarayıcının söz konusu yuvayla ilişkili belleği boşaltmayabileceğini unutmayın. Bu API'nin çağrılması, söz konusu alanla ilişkili div'in yeniden kullanılabilmesini sağlar.
Özellikle, bir alanın kaldırılması reklam GPT'nin uzun süreli sayfa görüntülemesinden kaldırılır. Bu nedenle gelecekteki istekler, bu reklamı içeren birlikte gösterimlerden veya rakip hariç tutmalardan etkilenmez. Sayfadan bir alanın div öğesi kaldırılmadan bu işlevin çağrılmaması, tanımlanmamış davranışa neden olur. -
- Örnek
-
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 (eski)
// 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();
-
Parametreler slots?: Slot[]
Yok edilecek slot dizisi. Dizi isteğe bağlıdır. Dizi belirtilmezse tüm alanlar kaldırılır. -
İlerlemeler boolean
Slotlar kaldırıldıysatrue
, aksi takdirdefalse
.
googletag.disablePublisherConsole
-
disablePublisherConsole(): void
-
Google Yayıncı Konsolu'nu devre dışı bırakır.
-
- Şunlara da bakabilirsiniz:
googletag.display
-
display(divOrSlot: string | Element | Slot): void
-
Slot hizmetleri için alanı oluşturma talimatı verir. Her reklam alanı her sayfa için yalnızca bir kez görüntülenmelidir. Gösterilmeden önce tüm alanlar tanımlanmalı ve kendileriyle ilişkilendirilmiş bir hizmete sahip olmalıdır. Öğe DOM'de mevcut olana kadar display çağrısı gerçekleşmemelidir. Bunu sağlamanın genel yöntemi, reklam öğesini yöntem çağrısında adlandırılmış div öğesi içindeki bir komut dosyası bloğuna yerleştirmektir.
Tekli istek mimarisi (SRA) kullanılıyorsa bu yöntemin çağrıldığı sırada getirilmemiş tüm reklam alanları bir kerede getirilir. Reklam alanını görüntülenmemeye zorlamak için div'in tamamı kaldırılmalıdır. -
- Örnek
-
JavaScript
googletag.cmd.push(() => { googletag.display("div-1"); });
JavaScript (eski)
googletag.cmd.push(function () { googletag.display("div-1"); });
TypeScript
googletag.cmd.push(() => { googletag.display("div-1"); });
- Şunlara da bakabilirsiniz:
-
Parametreler divOrSlot: string | Element | Slot
Reklam alanını veya div öğesini içeren div öğesinin kimliği ya da alan nesnesi. Bir div öğesi sağlanırsa,defineSlot
içine geçirilen kimlikle eşleşen bir "id" özelliğinin olması gerekir.
googletag.enableServices
-
enableServices(): void
-
Sayfadaki reklam alanları için tanımlanmış tüm GPT hizmetlerini etkinleştirir.
-
googletag.getVersion
-
getVersion(): string
-
GPT'nin geçerli sürümünü döndürür.
-
- Şunlara da bakabilirsiniz:
-
İlerlemeler string
Şu anda yürütülen GPT sürümü dizesi.
googletag.openConsole
-
openConsole(div?: string): void
-
Google Yayıncı Konsolu'nu açar.
-
- Örnek
-
JavaScript
// Calling with div ID. googletag.openConsole("div-1"); // Calling without div ID. googletag.openConsole();
JavaScript (eski)
// 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();
- Şunlara da bakabilirsiniz:
-
Parametreler div?: string
Reklam alanı div kimliği. Bu değer isteğe bağlıdır. Yayıncı Konsolu sağlandığında, belirtilen reklam alanının ayrıntıları görüntülenerek açılmaya çalışır.
googletag.pubads
-
pubads(): PubAdsService
-
PubAdsService
öğesine bir başvuru döndürür. -
-
İlerlemeler PubAdsService
Yayıncı Reklamları hizmeti.
googletag.setAdIframeTitle
-
setAdIframeTitle(title: string): void
-
Bundan sonra
PubAdsService
tarafından oluşturulan tüm reklam kapsayıcısı iframe'ler için başlığı ayarlar. -
- Örnek
-
JavaScript
googletag.setAdIframeTitle("title");
JavaScript (eski)
googletag.setAdIframeTitle("title");
TypeScript
googletag.setAdIframeTitle("title");
-
Parametreler title: string
Tüm reklam kapsayıcı iframe'leri için yeni başlık.
googletag.setConfig
-
setConfig(config: PageSettingsConfig): void
-
Sayfa için genel yapılandırma seçeneklerini ayarlar.
-
-
Parametreler config: PageSettingsConfig
googletag.sizeMapping
-
sizeMapping(): SizeMappingBuilder
-
Yeni bir
SizeMappingBuilder
oluşturur. -
- Şunlara da bakabilirsiniz:
-
İlerlemeler SizeMappingBuilder
Yeni bir derleyici.
googletag.CommandArray
Komut dizisi, bir işlev dizisini kabul eder ve bunları sırayla çağırır. GPT yüklendikten sonra işlevleri çağrılmak üzere sıraya almak için kullanılan standart bir dizi yerine kullanılması amaçlanmıştır.
Yöntem Özeti | |
---|---|
push
|
Bağımsız değişkenlerde belirtilen işlev sırasını sırayla yürütür.
|
push
-
push(...f: Array<(this: typeof globalThis) => void>): number
-
Bağımsız değişkenlerde belirtilen işlev sırasını sırayla yürütür.
-
- Örnek
-
JavaScript
googletag.cmd.push(() => { googletag.defineSlot("/1234567/sports", [160, 600]).addService(googletag.pubads()); });
JavaScript (eski)
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()); });
-
Parametreler ...f: Array<(this: typeof globalThis) => void>
Yürütülecek bir JavaScript işlevi. Çalışma zamanı bağlaması her zamanglobalThis
olur. Çevreleyen sözlük bağlamınınthis
değerini korumak için bir ok işlevi iletmeyi düşünün. -
İlerlemeler number
Şu ana kadar işlenen komutların sayısı. Bu,Array.push
'in döndürdüğü değerle (dizinin mevcut uzunluğu) uyumludur.
googletag.CompanionAdsService
Uzatmalar
Tamamlayıcı Reklam hizmeti. Bu hizmet, video reklamlar tarafından tamamlayıcı reklamları göstermek için kullanılır.
Yöntem Özeti | |
---|---|
addEventListener
|
Sayfada belirli bir GPT etkinliği meydana geldiğinde JavaScript işlevini ayarlamanıza ve çağırmanıza olanak tanıyan bir işleyici kaydeder.
Şu kuruluş biriminden devralındı:
|
getSlots
|
Bu hizmetle ilişkilendirilmiş slotların listesini alın.
Şu kuruluş biriminden devralındı:
|
removeEventListener
|
Önceden kaydedilmiş bir işleyiciyi kaldırır.
Şu kuruluş biriminden devralındı:
|
setRefreshUnfilledSlots
|
Doldurulmamış tamamlayıcı alanların otomatik olarak doldurulup doldurulmayacağını ayarlar.
|
- Şunlara da bakabilirsiniz:
setRefreshUnfilledSlots
-
setRefreshUnfilledSlots(value: boolean): void
-
Doldurulmamış tamamlayıcı alanların otomatik olarak doldurulup doldurulmayacağını ayarlar.
Bu yöntem, dolgunun açılıp kapatılması için sayfa ömrü boyunca birden çok kez çağrılabilir. YalnızcaPubAdsService
'e kayıtlı olan alanlar doldurulur. Politika kısıtlamaları nedeniyle bu yöntem, bir Ad Exchange videosu yayınlandığında boş tamamlayıcı alanları doldurmak için tasarlanmamıştır. -
- Örnek
-
JavaScript
googletag.companionAds().setRefreshUnfilledSlots(true);
JavaScript (eski)
googletag.companionAds().setRefreshUnfilledSlots(true);
TypeScript
googletag.companionAds().setRefreshUnfilledSlots(true);
-
Parametreler value: boolean
Doldurulmayan alanları otomatik olarak doldurmak içintrue
, değiştirmeden bırakmak içinfalse
.
googletag.PrivacySettingsConfig
Gizlilik ayarları için yapılandırma nesnesi.
Mülk Özeti | |
---|---|
childDirectedTreatment
|
Sayfanın çocuklara yönelik olarak değerlendirilmesi gerekip gerekmediğini belirtir.
|
limitedAds
|
Yayıncının yönetmeliklere uygunluk ihtiyaçlarına yardımcı olmak için yayınlamayı sınırlı reklamlar modunda yayınlanacak şekilde etkinleştirir.
|
nonPersonalizedAds
|
Yayıncı düzenlemelerine uygunluk ihtiyaçlarına yardımcı olmak için yayının kişiselleştirilmemiş reklamlar modunda yayınlanmasını sağlar.
|
restrictDataProcessing
|
Yayıncı düzenlemelerine uygunluk gereksinimlerine yardımcı olmak için yayınlamayı kısıtlı işleme modunda çalışacak şekilde etkinleştirir.
|
trafficSource
|
İsteklerin, satın alınmış trafiği mi yoksa organik trafiği mi temsil ettiğini belirtir.
|
underAgeOfConsent
|
Reklam isteklerinin reşit olma yaşının altındaki kullanıcılardan geliyor olarak işaretlenip işaretlenmeyeceğini belirtir.
|
- Şunlara da bakabilirsiniz:
childDirectedTreatment
-
childDirectedTreatment: null | boolean
-
Sayfanın çocuklara yönelik olarak değerlendirilmesi gerekip gerekmediğini belirtir. Yapılandırmayı temizlemek için ayarı
null
yapın. -
limitedAds
-
limitedAds: boolean
-
Yayıncının yönetmeliklere uygunluk ihtiyaçlarına yardımcı olmak için yayınlamayı sınırlı reklamlar modunda yayınlanacak şekilde etkinleştirir.
GPT'nin sınırlı reklamlar istemesini iki şekilde sağlayabilirsiniz:- IAB TCF 2.0 sürümü kullanıcı rızası yönetim platformundan gelen sinyal kullanılarak otomatik olarak.
- Manuel olarak, bu alanın değerini
true
olarak ayarlayarak.
CMP kullanılırken sınırlı reklamları manuel olarak etkinleştirmenin gerekli olmadığını unutmayın. -
- Örnek
-
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 (eski)
// 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, });
- Şunlara da bakabilirsiniz:
nonPersonalizedAds
-
nonPersonalizedAds: boolean
-
Yayıncı düzenlemelerine uygunluk ihtiyaçlarına yardımcı olmak için yayının kişiselleştirilmemiş reklamlar modunda yayınlanmasını sağlar.
-
restrictDataProcessing
-
restrictDataProcessing: boolean
-
Yayıncı düzenlemelerine uygunluk gereksinimlerine yardımcı olmak için yayınlamayı kısıtlı işleme modunda çalışacak şekilde etkinleştirir.
-
trafficSource
-
trafficSource: TrafficSource
-
İsteklerin, satın alınmış trafiği mi yoksa organik trafiği mi temsil ettiğini belirtir. Bu değer, Ad Manager raporlarındaki Trafik kaynağı boyutunu doldurur. Politika ayarlanmazsa raporlarda trafik kaynağı varsayılan olarak
undefined
olur. -
- Örnek
-
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 (eski)
// Indicate requests represent organic traffic. googletag.pubads().setPrivacySettings({ trafficSource: googletag.enums.TrafficSource.ORGANIC, }); // Indicate requests represent purchased traffic. googletag.pubads().setPrivacySettings({ trafficSource: googletag.enums.TrafficSource.PURCHASED, });
TypeScript
// Indicate requests represent organic traffic. googletag.pubads().setPrivacySettings({ trafficSource: googletag.enums.TrafficSource.ORGANIC, }); // Indicate requests represent purchased traffic. googletag.pubads().setPrivacySettings({ trafficSource: googletag.enums.TrafficSource.PURCHASED, });
underAgeOfConsent
-
underAgeOfConsent: null | boolean
-
Reklam isteklerinin reşit olma yaşının altındaki kullanıcılardan geliyor olarak işaretlenip işaretlenmeyeceğini belirtir. Yapılandırmayı temizlemek için ayarı
null
yapın. -
googletag.PubAdsService
Uzatmalar
Yayıncı Reklamları hizmeti. Bu hizmet, Google Ad Manager hesabınızdan reklam almak ve göstermek için kullanılır.
Yöntem Özeti | |
---|---|
addEventListener
|
Sayfada belirli bir GPT etkinliği meydana geldiğinde JavaScript işlevini ayarlamanıza ve çağırmanıza olanak tanıyan bir işleyici kaydeder.
Şu kuruluş biriminden devralındı:
|
clear
|
Reklamları verilen alanlardan kaldırır ve boş içerikle değiştirir.
|
clearCategoryExclusions
|
Tüm sayfa düzeyi reklam kategorisi hariç tutma etiketlerini temizler.
|
clearTargeting
|
Belirli bir anahtar veya tüm anahtarlar için özel hedefleme parametrelerini temizler.
|
collapseEmptyDivs
|
Alan div'lerinin, görüntülenecek reklam içeriği olmadığında sayfada yer kaplamaması için daraltılmasına olanak tanır.
|
disableInitialLoad
|
Sayfa yüklenirken reklam isteklerini devre dışı bırakır ancak
PubAdsService.refresh çağrısıyla reklam istenmesine izin verir.
|
display
|
Belirtilen reklam birimi yolu ve boyutuyla bir reklam alanı oluşturur ve gösterir.
|
enableLazyLoad
|
Yapılandırma nesnesi tarafından tanımlandığı gibi GPT'de geç yüklemeyi etkinleştirir.
|
enableSingleRequest
|
Aynı anda birden fazla reklam getirmek için tekli istek modunu etkinleştirir.
|
enableVideoAds
|
GPT'ye, video reklamların sayfada mevcut olacağını bildirir.
|
get
|
Verilen anahtarla ilişkili AdSense özelliğinin değerini döndürür.
|
getAttributeKeys
|
Bu hizmette ayarlanan özellik anahtarlarını döndürür.
|
getSlots
|
Bu hizmetle ilişkilendirilmiş slotların listesini alın.
Şu kuruluş biriminden devralındı:
|
getTargeting
|
Ayarlanmış belirli bir özel hizmet düzeyinde hedefleme parametresini döndürür.
|
getTargetingKeys
|
Ayarlanan tüm özel hizmet düzeyinde hedefleme anahtarlarının listesini döndürür.
|
isInitialLoadDisabled
|
Reklamlara yönelik ilk isteklerin önceki bir
PubAdsService.disableInitialLoad çağrısı tarafından başarıyla devre dışı bırakılıp bırakılmadığını döndürür.
|
refresh
|
Sayfadaki belirli alanlar veya tüm alanlar için yeni reklamlar getirir ve görüntüler.
|
removeEventListener
|
Önceden kaydedilmiş bir işleyiciyi kaldırır.
Şu kuruluş biriminden devralındı:
|
set
|
Yayıncı Reklamları hizmeti altındaki tüm reklam alanları için geçerli olan AdSense özelliklerinin değerlerini ayarlar.
|
setCategoryExclusion
|
Belirli bir etiket adı için sayfa düzeyinde reklam kategorisi hariç tutma ayarlar.
|
setCentering
|
Reklamların yatay ortalanmasını etkinleştirir ve devre dışı bırakır.
|
setForceSafeFrame
|
Sayfadaki tüm reklamların SafeFrame kapsayıcısı kullanılarak oluşturulmaya zorlanıp zorlanmayacağını yapılandırır.
|
setLocation
|
Satır öğelerini belirli konumlara coğrafi olarak hedefleyebilmeniz için web sitelerinden konum bilgilerini aktarır.
|
setPrivacySettings
|
Bir yapılandırma nesnesi kullanılarak tek bir API'den tüm gizlilik ayarlarının yapılandırılmasına olanak tanır.
|
setPublisherProvidedId
|
Yayıncı tarafından sağlanan kimliğin değerini ayarlar.
|
setSafeFrameConfig
|
SafeFrame yapılandırması için sayfa düzeyinde tercihleri ayarlar.
|
setTargeting
|
Tüm Yayıncı Reklamları hizmet reklam alanları için geçerli olan belirli bir anahtarın özel hedefleme parametrelerini ayarlar.
|
setVideoContent
|
Hedefleme ve içerik hariç tutma amaçlarına yönelik reklam istekleriyle birlikte gönderilecek video içeriği bilgilerini ayarlar.
|
updateCorrelator
|
Reklam istekleriyle gönderilen ilişkilendiriciyi değiştirerek yeni bir sayfa görüntüleme işlemini etkili bir şekilde başlatır.
|
clear
-
clear(slots?: Slot[]): boolean
-
Reklamları verilen alanlardan kaldırır ve boş içerikle değiştirir. Alanlar, getirilmedi olarak işaretlenir.
Özellikle, bir alanın temizlenmesi reklam GPT'nin uzun süreli sayfa görüntülemesinden kaldırılır. Bu nedenle gelecekteki istekler, bu reklamı içeren birlikte gösterimlerden veya rakip hariç tutmalardan etkilenmez. -
- Örnek
-
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 (eski)
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();
-
Parametreler slots?: Slot[]
Temizlenecek slot dizisi. Dizi isteğe bağlıdır. Belirtilmemişse tüm alanlar temizlenir. -
İlerlemeler boolean
Alanlar temizlenmişsetrue
, aksi takdirdefalse
döndürür.
clearCategoryExclusions
-
clearCategoryExclusions(): PubAdsService
-
Tüm sayfa düzeyi reklam kategorisi hariç tutma etiketlerini temizler. Bu, alanı yenilemek istiyorsanız yararlı olur.
-
- Örnek
-
JavaScript
// Set category exclusion to exclude ads with 'AirlineAd' labels. googletag.pubads().setCategoryExclusion("AirlineAd"); // Make ad requests. No ad with 'AirlineAd' label will be returned. // Clear category exclusions so all ads can be returned. googletag.pubads().clearCategoryExclusions(); // Make ad requests. Any ad can be returned.
JavaScript (eski)
// Set category exclusion to exclude ads with 'AirlineAd' labels. googletag.pubads().setCategoryExclusion("AirlineAd"); // Make ad requests. No ad with 'AirlineAd' label will be returned. // Clear category exclusions so all ads can be returned. googletag.pubads().clearCategoryExclusions(); // Make ad requests. Any ad can be returned.
TypeScript
// Set category exclusion to exclude ads with 'AirlineAd' labels. googletag.pubads().setCategoryExclusion("AirlineAd"); // Make ad requests. No ad with 'AirlineAd' label will be returned. // Clear category exclusions so all ads can be returned. googletag.pubads().clearCategoryExclusions(); // Make ad requests. Any ad can be returned.
- Şunlara da bakabilirsiniz:
-
İlerlemeler PubAdsService
Yöntemin çağrıldığı hizmet nesnesi.
clearTargeting
-
clearTargeting(key?: string): PubAdsService
-
Belirli bir anahtar veya tüm anahtarlar için özel hedefleme parametrelerini temizler.
-
- Örnek
-
JavaScript
googletag.pubads().setTargeting("interests", "sports"); googletag.pubads().setTargeting("colors", "blue"); googletag.pubads().setTargeting("fruits", "apple"); googletag.pubads().clearTargeting("interests"); // Targeting 'colors' and 'fruits' are still present, while 'interests' // was cleared. googletag.pubads().clearTargeting(); // All targeting has been cleared.
JavaScript (eski)
googletag.pubads().setTargeting("interests", "sports"); googletag.pubads().setTargeting("colors", "blue"); googletag.pubads().setTargeting("fruits", "apple"); googletag.pubads().clearTargeting("interests"); // Targeting 'colors' and 'fruits' are still present, while 'interests' // was cleared. googletag.pubads().clearTargeting(); // All targeting has been cleared.
TypeScript
googletag.pubads().setTargeting("interests", "sports"); googletag.pubads().setTargeting("colors", "blue"); googletag.pubads().setTargeting("fruits", "apple"); googletag.pubads().clearTargeting("interests"); // Targeting 'colors' and 'fruits' are still present, while 'interests' // was cleared. googletag.pubads().clearTargeting(); // All targeting has been cleared.
- Şunlara da bakabilirsiniz:
-
Parametreler key?: string
Hedefleme parametresi anahtarı. Anahtar isteğe bağlıdır. Belirtilmemişse tüm hedefleme parametreleri silinir. -
İlerlemeler PubAdsService
Yöntemin çağrıldığı hizmet nesnesi.
collapseEmptyDivs
-
collapseEmptyDivs(collapseBeforeAdFetch?: boolean): boolean
-
Alan div'lerinin, görüntülenecek reklam içeriği olmadığında sayfada yer kaplamaması için daraltılmasına olanak tanır. Bu mod, hizmet etkinleştirilmeden önce ayarlanmalıdır.
-
- Şunlara da bakabilirsiniz:
-
Parametreler collapseBeforeAdFetch?: boolean
Reklamlar getirilmeden önce bile alanların daraltılıp daraltılmayacağını belirler. Bu parametre isteğe bağlıdır. Sağlanmazsa varsayılan değer olarakfalse
kullanılır. -
İlerlemeler boolean
Div daraltma modu etkinsetrue
değerini, yöntem hizmet etkinleştirildikten sonra çağrıldığı için daraltma modunun etkinleştirilmesi mümkün değilsefalse
değerini döndürür.
disableInitialLoad
-
disableInitialLoad(): void
-
Sayfa yüklenirken reklam isteklerini devre dışı bırakır ancak
PubAdsService.refresh
çağrısıyla reklam istenmesine izin verir. Bu ayar, hizmet etkinleştirilmeden önce ayarlanmalıdır. Eş zamansız mod kullanılmalıdır. Aksi takdirde,refresh
kullanarak reklam istemek mümkün olmaz. -
- Şunlara da bakabilirsiniz:
display
-
display(adUnitPath: string, size: GeneralSize, div?: string | Element, clickUrl?: string): void
-
Belirtilen reklam birimi yolu ve boyutuyla bir reklam alanı oluşturur ve gösterir. Bu yöntem tekli istek moduyla çalışmaz.
Not: Bu yöntem çağrıldığında, reklam isteği gönderilirken ve yanıt oluşturulurken tutarlılığı sağlamak için alanın ve sayfa durumunun anlık görüntüsü oluşturulur. Bu yöntem çağrıldıktan sonra alan veya sayfa durumunda yapılan değişiklikler (hedefleme, gizlilik ayarları, SafeFrame'i zorunlu kılma vb. dahil) yalnızca sonrakidisplay()
veyarefresh()
istekleri için geçerli olur. -
- Örnek
-
JavaScript
googletag.pubads().display("/1234567/sports", [728, 90], "div-1");
JavaScript (eski)
googletag.pubads().display("/1234567/sports", [728, 90], "div-1");
TypeScript
googletag.pubads().display("/1234567/sports", [728, 90], "div-1");
- Şunlara da bakabilirsiniz:
-
Parametreler adUnitPath: string
Oluşturulacak alanın reklam birimi yolu.size: GeneralSize
Alanın genişliği ve yüksekliği.div?: string | Element
Alanı içeren div öğesinin kimliği veya div öğesinin kimliği.clickUrl?: string
Bu alanda kullanılacak tıklama URL'si.
enableLazyLoad
-
enableLazyLoad(config?: { fetchMarginPercent: number, mobileScaling: number, renderMarginPercent: number }): void
-
Yapılandırma nesnesi tarafından tanımlandığı gibi GPT'de geç yüklemeyi etkinleştirir. Daha ayrıntılı örnekler için Geç yükleme örneğine bakın.
Not: SRA'da geç getirme yalnızca tüm alanlar getirme kenar boşluğunun dışında olduğunda çalışır. -
- Örnek
-
JavaScript
googletag.pubads().enableLazyLoad({ // Fetch slots within 5 viewports. fetchMarginPercent: 500, // Render slots within 2 viewports. renderMarginPercent: 200, // Double the above values on mobile. mobileScaling: 2.0, });
JavaScript (eski)
googletag.pubads().enableLazyLoad({ // Fetch slots within 5 viewports. fetchMarginPercent: 500, // Render slots within 2 viewports. renderMarginPercent: 200, // Double the above values on mobile. mobileScaling: 2.0, });
TypeScript
googletag.pubads().enableLazyLoad({ // Fetch slots within 5 viewports. fetchMarginPercent: 500, // Render slots within 2 viewports. renderMarginPercent: 200, // Double the above values on mobile. mobileScaling: 2.0, });
- Şunlara da bakabilirsiniz:
-
Parametreler config?: { fetchMarginPercent: number, mobileScaling: number, renderMarginPercent: number }
Yapılandırma nesnesi, geç davranışın özelleştirilmesine olanak tanır. Atlanan yapılandırmalar, Google tarafından ayarlanan ve zaman içinde ayarlanan varsayılan bir yapılandırma kullanır. Getirme marjı gibi belirli bir ayarı devre dışı bırakmak için değeri-1
olarak ayarlayın.fetchMarginPercent
Reklamı görüntü alanı boyutunun yüzdesi olarak getirebilmemiz için bir alanın mevcut görüntü alanından olması gereken minimum mesafe. 0 değeri, "alan görüntü alanına girdiğinde", 100, "reklam 1 görüntü alanı uzakta olduğunda" anlamına gelir ve bu böyle devam eder.renderMarginPercent
Reklam oluşturulmadan önce alanın mevcut görüntü alanından olması gereken minimum mesafe. Bu, reklamın önceden getirilmesine ancak diğer alt kaynakların oluşturulmasının ve indirilmesinin beklenmesine olanak tanır. Bu değer, görüntü alanının yüzdesi olarakfetchMarginPercent
ile aynı şekilde çalışır.mobileScaling
Mobil cihazlarda kenar boşluklarına uygulanan bir çarpan. Bu, mobil ve masaüstü cihazlarda farklı kâr marjlarına olanak tanır. Örneğin, 2, 0 değeri mobil cihazlarda tüm kenar boşluklarını 2 ile çarparak bir alanın getirme ve oluşturma işleminden önce olabileceği minimum mesafeyi artırır.
enableSingleRequest
-
enableSingleRequest(): boolean
-
Aynı anda birden fazla reklam getirmek için tekli istek modunu etkinleştirir. Bunun için, hizmeti etkinleştirmeden önce tüm Yayıncı Reklamları alanlarının tanımlanması ve PubAdsService'e eklenmesi gerekir. Hizmet etkinleştirilmeden önce tekli istek modu ayarlanmalıdır.
-
- Şunlara da bakabilirsiniz:
-
İlerlemeler boolean
Yöntem hizmet etkinleştirildikten sonra çağrıldığı için tekli istek modu etkinleştirilmişsetrue
ve tekli istek modunu etkinleştirmek mümkün değilsefalse
değerini döndürür.
enableVideoAds
-
enableVideoAds(): void
-
GPT'ye, video reklamların sayfada mevcut olacağını bildirir. Bu, görüntülü ve video reklamlarda rakip hariç tutma kısıtlamalarına olanak tanır. Video içeriği biliniyorsa görüntülü reklamlar için içerik hariç tutma özelliğini kullanabilmek üzere
PubAdsService.setVideoContent
numaralı telefonu arayın. -
get
-
get(key: string): null | string
-
Verilen anahtarla ilişkili AdSense özelliğinin değerini döndürür.
-
- Örnek
-
JavaScript
googletag.pubads().set("adsense_background_color", "#FFFFFF"); googletag.pubads().get("adsense_background_color"); // Returns '#FFFFFF'.
JavaScript (eski)
googletag.pubads().set("adsense_background_color", "#FFFFFF"); googletag.pubads().get("adsense_background_color"); // Returns '#FFFFFF'.
TypeScript
googletag.pubads().set("adsense_background_color", "#FFFFFF"); googletag.pubads().get("adsense_background_color"); // Returns '#FFFFFF'.
- Şunlara da bakabilirsiniz:
-
Parametreler key: string
Aranacak özelliğin adı. -
İlerlemeler null | string
Özellik anahtarı için geçerli değer veya anahtar yoksanull
.
getAttributeKeys
-
getAttributeKeys(): string[]
-
Bu hizmette ayarlanan özellik anahtarlarını döndürür.
-
- Örnek
-
JavaScript
googletag.pubads().set("adsense_background_color", "#FFFFFF"); googletag.pubads().set("adsense_border_color", "#AABBCC"); googletag.pubads().getAttributeKeys(); // Returns ['adsense_background_color', 'adsense_border_color'].
JavaScript (eski)
googletag.pubads().set("adsense_background_color", "#FFFFFF"); googletag.pubads().set("adsense_border_color", "#AABBCC"); googletag.pubads().getAttributeKeys(); // Returns ['adsense_background_color', 'adsense_border_color'].
TypeScript
googletag.pubads().set("adsense_background_color", "#FFFFFF"); googletag.pubads().set("adsense_border_color", "#AABBCC"); googletag.pubads().getAttributeKeys(); // Returns ['adsense_background_color', 'adsense_border_color'].
-
İlerlemeler string[]
Bu hizmette ayarlanan özellik anahtarları dizisi. Sıralama tanımsız.
getTargeting
-
getTargeting(key: string): string[]
-
Ayarlanmış belirli bir özel hizmet düzeyinde hedefleme parametresini döndürür.
-
- Örnek
-
JavaScript
googletag.pubads().setTargeting("interests", "sports"); googletag.pubads().getTargeting("interests"); // Returns ['sports']. googletag.pubads().getTargeting("age"); // Returns [] (empty array).
JavaScript (eski)
googletag.pubads().setTargeting("interests", "sports"); googletag.pubads().getTargeting("interests"); // Returns ['sports']. googletag.pubads().getTargeting("age"); // Returns [] (empty array).
TypeScript
googletag.pubads().setTargeting("interests", "sports"); googletag.pubads().getTargeting("interests"); // Returns ['sports']. googletag.pubads().getTargeting("age"); // Returns [] (empty array).
-
Parametreler key: string
Aranacak hedefleme anahtarı. -
İlerlemeler string[]
Bu anahtarla ilişkilendirilen değerler veya böyle bir anahtar yoksa boş dizi.
getTargetingKeys
-
getTargetingKeys(): string[]
-
Ayarlanan tüm özel hizmet düzeyinde hedefleme anahtarlarının listesini döndürür.
-
- Örnek
-
JavaScript
googletag.pubads().setTargeting("interests", "sports"); googletag.pubads().setTargeting("colors", "blue"); googletag.pubads().getTargetingKeys(); // Returns ['interests', 'colors'].
JavaScript (eski)
googletag.pubads().setTargeting("interests", "sports"); googletag.pubads().setTargeting("colors", "blue"); googletag.pubads().getTargetingKeys(); // Returns ['interests', 'colors'].
TypeScript
googletag.pubads().setTargeting("interests", "sports"); googletag.pubads().setTargeting("colors", "blue"); googletag.pubads().getTargetingKeys(); // Returns ['interests', 'colors'].
-
İlerlemeler string[]
Hedefleme anahtarları dizisi. Sıralama tanımsız.
isInitialLoadDisabled
-
isInitialLoadDisabled(): boolean
-
Reklamlara yönelik ilk isteklerin önceki bir
PubAdsService.disableInitialLoad
çağrısı tarafından başarıyla devre dışı bırakılıp bırakılmadığını döndürür. -
-
İlerlemeler boolean
PubAdsService.disableInitialLoad
için yapılan önceki bir çağrı başarılı olduysatrue
, aksi takdirdefalse
döndürür.
refresh
-
refresh(slots?: null | Slot[], options?: { changeCorrelator: boolean }): void
-
Sayfadaki belirli alanlar veya tüm alanlar için yeni reklamlar getirir ve görüntüler. Yalnızca eşzamansız oluşturma modunda çalışır.
Tüm tarayıcılarda doğru davranış içinrefresh
çağrısından önce reklam alanınadisplay
çağrısı yapılmalıdır.display
çağrısı atlanırsa yenileme beklenmedik şekilde davranabilir. İstenirsedisplay
uygulamasının bir reklamı getirmesini durdurmak içinPubAdsService.disableInitialLoad
yöntemi kullanılabilir.
Bir alanı yenilemek eski reklamı GPT'nin uzun süreli sayfa görüntülemesinden kaldırır. Böylece gelecekteki istekler, söz konusu reklamı içeren birlikte gösterimlerden veya rakip hariç tutmalardan etkilenmez. -
- Örnek
-
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 (eski)
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 });
- Şunlara da bakabilirsiniz:
-
Parametreler slots?: null | Slot[]
Yenilenecek alanlar. Dizi isteğe bağlıdır. Belirtilmemişse tüm alanlar yenilenir.options?: { changeCorrelator: boolean }
Bu yenileme çağrısıyla ilişkili yapılandırma seçenekleri.changeCorrelator
Reklamları getirmek için yeni bir ilişkilendirici oluşturulup oluşturulmayacağını belirtir. Reklam sunucularımız, bu ilişkilendirici değerini kısa bir süre için (şu anda 30 saniye için, ancak değişebilir) korur. Böylece, aynı ilişkilendiriciye sahip, birbirine yakın şekilde alınan istekler tek bir sayfa görüntüleme olarak kabul edilir. Varsayılan olarak her yenileme için yeni bir ilişkilendirici oluşturulur.
Not: Bu seçeneğin, GPT'nin uzun süreli sayfa görüntülemesi üzerinde hiçbir etkisi yoktur. Uzun süreli sayfa görüntülemesi, geçerli olarak sayfada bulunan reklamları otomatik olarak yansıtır ve son kullanma tarihi yoktur.
set
-
set(key: string, value: string): PubAdsService
-
Yayıncı Reklamları hizmeti altındaki tüm reklam alanları için geçerli olan AdSense özelliklerinin değerlerini ayarlar.
Bu özelliğin aynı anahtar için birden fazla kez çağrılması, söz konusu anahtar için daha önce ayarlanmış olan değerleri geçersiz kılar.display
veyarefresh
çağrılmadan önce tüm değerler ayarlanmalıdır. -
- Örnek
-
JavaScript
googletag.pubads().set("adsense_background_color", "#FFFFFF");
JavaScript (eski)
googletag.pubads().set("adsense_background_color", "#FFFFFF");
TypeScript
googletag.pubads().set("adsense_background_color", "#FFFFFF");
- Şunlara da bakabilirsiniz:
-
Parametreler key: string
Özelliğin adı.value: string
Özellik değeri. -
İlerlemeler PubAdsService
Yöntemin çağrıldığı hizmet nesnesi.
setCategoryExclusion
-
setCategoryExclusion(categoryExclusion: string): PubAdsService
-
Belirli bir etiket adı için sayfa düzeyinde reklam kategorisi hariç tutma ayarlar.
-
- Örnek
-
JavaScript
// Label = AirlineAd. googletag.pubads().setCategoryExclusion("AirlineAd");
JavaScript (eski)
// Label = AirlineAd. googletag.pubads().setCategoryExclusion("AirlineAd");
TypeScript
// Label = AirlineAd. googletag.pubads().setCategoryExclusion("AirlineAd");
- Şunlara da bakabilirsiniz:
-
Parametreler categoryExclusion: string
Eklenecek reklam kategorisi hariç tutma etiketi. -
İlerlemeler PubAdsService
Yöntemin çağrıldığı hizmet nesnesi.
setCentering
-
setCentering(centerAds: boolean): void
-
Reklamların yatay ortalanmasını etkinleştirir ve devre dışı bırakır. Ortalama varsayılan olarak devre dışıdır. Eski gpt_mobile.js'de ortalama olarak ortalama etkin durumdadır.
Bu yöntem,display
veyarefresh
çağrılmadan önce çağrılmalıdır çünkü yalnızca bu yöntem çağrıldıktan sonra istenen reklamlar ortalanır. -
- Örnek
-
JavaScript
// Make ads centered. googletag.pubads().setCentering(true);
JavaScript (eski)
// Make ads centered. googletag.pubads().setCentering(true);
TypeScript
// Make ads centered. googletag.pubads().setCentering(true);
-
Parametreler centerAds: boolean
Reklamları ortalamak içintrue
, sola hizalamak içinfalse
.
setForceSafeFrame
-
setForceSafeFrame(forceSafeFrame: boolean): PubAdsService
-
Sayfadaki tüm reklamların SafeFrame kapsayıcısı kullanılarak oluşturulmaya zorlanıp zorlanmayacağını yapılandırır.
Bu API'yi kullanırken lütfen aşağıdakileri göz önünde bulundurun:- Bu ayar, yalnızca ilgili alanlar için yapılmış sonraki reklam isteklerinde geçerli olur.
- Alan seviyesindeki ayar (belirtilmişse) sayfa düzeyindeki ayarı her zaman geçersiz kılar.
true
olarak ayarlanırsa (alan düzeyinde veya sayfa düzeyinde) reklam, Google Ad Manager kullanıcı arayüzünde yapılan seçimden bağımsız olarak her zaman bir SafeFrame kapsayıcısı kullanılarak oluşturulur.- Ancak
false
olarak ayarlanırsa veya belirtilmemişse reklam, reklam öğesinin türüne ve Google Ad Manager kullanıcı arayüzünde yapılan seçime bağlı olarak bir SafeFrame kapsayıcısı kullanılarak oluşturulur. - Bu API, iFrame'lerini çıkarmaya çalışan veya doğrudan bir yayıncı sayfasında oluşturulmasına güvenen reklam öğelerinin davranışını etkileyebileceği için dikkatli kullanılmalıdır.
-
- Örnek
-
JavaScript
googletag.pubads().setForceSafeFrame(true); // The following slot will be opted-out of the page-level force // SafeFrame instruction. googletag .defineSlot("/1234567/sports", [160, 600], "div-1") .setForceSafeFrame(false) .addService(googletag.pubads()); // The following slot will have SafeFrame forced. googletag.defineSlot("/1234567/news", [160, 600], "div-2").addService(googletag.pubads()); googletag.display("div-1"); googletag.display("div-2");
JavaScript (eski)
googletag.pubads().setForceSafeFrame(true); // The following slot will be opted-out of the page-level force // SafeFrame instruction. googletag .defineSlot("/1234567/sports", [160, 600], "div-1") .setForceSafeFrame(false) .addService(googletag.pubads()); // The following slot will have SafeFrame forced. googletag.defineSlot("/1234567/news", [160, 600], "div-2").addService(googletag.pubads()); googletag.display("div-1"); googletag.display("div-2");
TypeScript
googletag.pubads().setForceSafeFrame(true); // The following slot will be opted-out of the page-level force // SafeFrame instruction. googletag .defineSlot("/1234567/sports", [160, 600], "div-1")! .setForceSafeFrame(false) .addService(googletag.pubads()); // The following slot will have SafeFrame forced. googletag.defineSlot("/1234567/news", [160, 600], "div-2")!.addService(googletag.pubads()); googletag.display("div-1"); googletag.display("div-2");
- Şunlara da bakabilirsiniz:
-
Parametreler forceSafeFrame: boolean
Sayfadaki tüm reklamları SafeFrame'lerde oluşturulmaya zorlamak içintrue
ve önceki ayarı "yanlış" olarak değiştirmek içinfalse
. Daha önce belirtilmediğinde bu seçeneğinfalse
olarak ayarlanması hiçbir şeyi değiştirmez. -
İlerlemeler PubAdsService
İşlevin çağrıldığı hizmet nesnesi.
setLocation
-
setLocation(address: string): PubAdsService
-
Satır öğelerini belirli konumlara coğrafi olarak hedefleyebilmeniz için web sitelerinden konum bilgilerini aktarır.
-
- Örnek
-
JavaScript
// Postal code: googletag.pubads().setLocation("10001,US");
JavaScript (eski)
// Postal code: googletag.pubads().setLocation("10001,US");
TypeScript
// Postal code: googletag.pubads().setLocation("10001,US");
-
Parametreler address: string
Serbest biçimli adres. -
İlerlemeler PubAdsService
Yöntemin çağrıldığı hizmet nesnesi.
setPrivacySettings
-
setPrivacySettings(privacySettings: PrivacySettingsConfig): PubAdsService
-
Bir yapılandırma nesnesi kullanılarak tek bir API'den tüm gizlilik ayarlarının yapılandırılmasına olanak tanır.
-
- Örnek
-
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 (eski)
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, });
- Şunlara da bakabilirsiniz:
-
Parametreler privacySettings: PrivacySettingsConfig
Gizlilik ayarları yapılandırmasını içeren nesne. -
İlerlemeler PubAdsService
İşlevin çağrıldığı hizmet nesnesi.
setPublisherProvidedId
-
setPublisherProvidedId(ppid: string): PubAdsService
-
Yayıncı tarafından sağlanan kimliğin değerini ayarlar.
-
- Örnek
-
JavaScript
googletag.pubads().setPublisherProvidedId("12JD92JD8078S8J29SDOAKC0EF230337");
JavaScript (eski)
googletag.pubads().setPublisherProvidedId("12JD92JD8078S8J29SDOAKC0EF230337");
TypeScript
googletag.pubads().setPublisherProvidedId("12JD92JD8078S8J29SDOAKC0EF230337");
- Şunlara da bakabilirsiniz:
-
Parametreler ppid: string
Yayıncı tarafından sağlanan alfanümerik bir kimlik. 32 ile 150 karakter arasında olmalıdır. -
İlerlemeler PubAdsService
Yöntemin çağrıldığı hizmet nesnesi.
setSafeFrameConfig
-
setSafeFrameConfig(config: SafeFrameConfig): PubAdsService
-
SafeFrame yapılandırması için sayfa düzeyinde tercihleri ayarlar. Yapılandırma nesnesindeki tanınmayan anahtarlar yoksayılır. Tanınan bir anahtar için geçersiz bir değer iletilirse yapılandırmanın tamamı yoksayılır.
Bu sayfa düzeyindeki tercihler, belirtilirse alan düzeyindeki tercihler tarafından geçersiz kılınır. -
- Örnek
-
JavaScript
googletag.pubads().setForceSafeFrame(true); const pageConfig = { allowOverlayExpansion: true, allowPushExpansion: true, sandbox: true, }; const slotConfig = { allowOverlayExpansion: false }; googletag.pubads().setSafeFrameConfig(pageConfig); // The following slot will not allow for expansion by overlay. googletag .defineSlot("/1234567/sports", [160, 600], "div-1") .setSafeFrameConfig(slotConfig) .addService(googletag.pubads()); // The following slot will inherit the page level settings, and hence // would allow for expansion by overlay. googletag.defineSlot("/1234567/news", [160, 600], "div-2").addService(googletag.pubads()); googletag.display("div-1"); googletag.display("div-2");
JavaScript (eski)
googletag.pubads().setForceSafeFrame(true); var pageConfig = { allowOverlayExpansion: true, allowPushExpansion: true, sandbox: true, }; var slotConfig = { allowOverlayExpansion: false }; googletag.pubads().setSafeFrameConfig(pageConfig); // The following slot will not allow for expansion by overlay. googletag .defineSlot("/1234567/sports", [160, 600], "div-1") .setSafeFrameConfig(slotConfig) .addService(googletag.pubads()); // The following slot will inherit the page level settings, and hence // would allow for expansion by overlay. googletag.defineSlot("/1234567/news", [160, 600], "div-2").addService(googletag.pubads()); googletag.display("div-1"); googletag.display("div-2");
TypeScript
googletag.pubads().setForceSafeFrame(true); const pageConfig = { allowOverlayExpansion: true, allowPushExpansion: true, sandbox: true, }; const slotConfig = { allowOverlayExpansion: false }; googletag.pubads().setSafeFrameConfig(pageConfig); // The following slot will not allow for expansion by overlay. googletag .defineSlot("/1234567/sports", [160, 600], "div-1")! .setSafeFrameConfig(slotConfig) .addService(googletag.pubads()); // The following slot will inherit the page level settings, and hence // would allow for expansion by overlay. googletag.defineSlot("/1234567/news", [160, 600], "div-2")!.addService(googletag.pubads()); googletag.display("div-1"); googletag.display("div-2");
- Şunlara da bakabilirsiniz:
-
Parametreler config: SafeFrameConfig
Yapılandırma nesnesi. -
İlerlemeler PubAdsService
Yöntemin çağrıldığı hizmet nesnesi.
setTargeting
-
setTargeting(key: string, value: string | string[]): PubAdsService
-
Tüm Yayıncı Reklamları hizmet reklam alanları için geçerli olan belirli bir anahtarın özel hedefleme parametrelerini ayarlar. Bu işlevi aynı anahtar için birden çok kez çağırmak, eski değerlerin üzerine yazılmasına neden olur. Bu anahtarlar Google Ad Manager hesabınızda tanımlanır.
-
- Örnek
-
JavaScript
// Example with a single value for a key. googletag.pubads().setTargeting("interests", "sports"); // Example with multiple values for a key inside in an array. googletag.pubads().setTargeting("interests", ["sports", "music"]);
JavaScript (eski)
// Example with a single value for a key. googletag.pubads().setTargeting("interests", "sports"); // Example with multiple values for a key inside in an array. googletag.pubads().setTargeting("interests", ["sports", "music"]);
TypeScript
// Example with a single value for a key. googletag.pubads().setTargeting("interests", "sports"); // Example with multiple values for a key inside in an array. googletag.pubads().setTargeting("interests", ["sports", "music"]);
- Şunlara da bakabilirsiniz:
-
Parametreler key: string
Hedefleme parametresi anahtarı.value: string | string[]
Hedefleme parametresi değeri veya değer dizisi. -
İlerlemeler PubAdsService
Yöntemin çağrıldığı hizmet nesnesi.
setVideoContent
-
setVideoContent(videoContentId: string, videoCmsId: string): void
-
Hedefleme ve içerik hariç tutma amaçlarına yönelik reklam istekleriyle birlikte gönderilecek video içeriği bilgilerini ayarlar. Bu yöntem çağrıldığında video reklamlar otomatik olarak etkinleştirilir.
videoContentId
vevideoCmsId
için Google Ad Manager içerik besleme hizmetine sağlanan değerleri kullanın. -
- Şunlara da bakabilirsiniz:
-
Parametreler videoContentId: string
Video içerik kimliği.videoCmsId: string
Video İYS kimliği.
updateCorrelator
-
updateCorrelator(): PubAdsService
-
Reklam istekleriyle gönderilen ilişkilendiriciyi değiştirerek yeni bir sayfa görüntüleme işlemini etkili bir şekilde başlatır. İlişkilendirici, tek bir sayfa görüntülemesinden gelen tüm reklam istekleri için aynıdır ve farklı sayfa görüntülemelerinde benzersizdir. Yalnızca eşzamansız mod için geçerlidir.
Not: Bu durum, GPT'nin uzun süreli sayfa görüntülemesini etkilemez. Uzun süreli sayfa görüntülemesi, reklamları gerçekten sayfada otomatik olarak yansıtır ve geçerlilik süresi yoktur. -
- Örnek
-
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 (eski)
// 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.
-
İlerlemeler PubAdsService
İşlevin çağrıldığı hizmet nesnesi.
googletag.ResponseInformation
Tek bir reklam yanıtını temsil eden bir nesne.
Mülk Özeti | |
---|---|
advertiserId
|
Reklamverenin kimliği.
|
campaignId
|
Kampanyanın kimliği.
|
creativeId
|
Reklam öğesinin kimliği.
|
creativeTemplateId
|
Reklamın şablon kimliği.
|
lineItemId
|
Satır öğesinin kimliği.
|
- Şunlara da bakabilirsiniz:
advertiserId
-
advertiserId: null | number
-
Reklamverenin kimliği.
-
campaignId
-
campaignId: null | number
-
Kampanyanın kimliği.
-
creativeId
-
creativeId: null | number
-
Reklam öğesinin kimliği.
-
creativeTemplateId
-
creativeTemplateId: null | number
-
Reklamın şablon kimliği.
-
lineItemId
-
lineItemId: null | number
-
Satır öğesinin kimliği.
-
googletag.RewardedPayload
Ödüllü bir reklamla ilişkili ödülü temsil eden bir nesne
Mülk Özeti | |
---|---|
amount
|
Ödüle dahil edilen öğe sayısı.
|
type
|
Ödüle dahil edilen öğenin türü (örneğin, "para").
|
- Şunlara da bakabilirsiniz:
amount
-
amount: number
-
Ödüle dahil edilen öğe sayısı.
-
type
-
type: string
-
Ödüle dahil edilen öğenin türü (örneğin, "para").
-
googletag.SafeFrameConfig
SafeFrame kapsayıcıları için yapılandırma nesnesi.
Mülk Özeti | |
---|---|
allowOverlayExpansion
|
SafeFrame'in reklam içeriğinin, sayfa içeriği ile yer paylaşımlı olarak genişletilmesine izin verip vermemesi gerektiği.
|
allowPushExpansion
|
SafeFrame'in sayfa içeriğini aktararak reklam içeriğinin genişletilmesine izin verip vermemesi.
|
sandbox
|
SafeFrame'in kullanıcı etkileşimi olmadan üst düzeyde gezinmeyi önlemek için HTML5 korumalı alan özelliğini kullanıp kullanmayacağı.
|
useUniqueDomain
|
Kullanımdan kaldırıldı.
SafeFrame'in Rezervasyon reklam öğeleri için rastgele alt alan adları kullanıp kullanmayacağı.
|
- Şunlara da bakabilirsiniz:
allowOverlayExpansion
-
allowOverlayExpansion: boolean
-
SafeFrame'in reklam içeriğinin, sayfa içeriği ile yer paylaşımlı olarak genişletilmesine izin verip vermemesi gerektiği.
-
allowPushExpansion
-
allowPushExpansion: boolean
-
SafeFrame'in sayfa içeriğini aktararak reklam içeriğinin genişletilmesine izin verip vermemesi.
-
sandbox
-
sandbox: boolean
-
SafeFrame'in kullanıcı etkileşimi olmadan üst düzeyde gezinmeyi önlemek için HTML5 korumalı alan özelliğini kullanıp kullanmayacağı. Geçerli tek değer
true
değeridir (false
değerine zorlanamaz). Korumalı alan özelliğinin eklentileri (ör. Flash) devre dışı bıraktığını unutmayın. -
useUniqueDomain
-
useUniqueDomain: null | boolean
-
SafeFrame'in Rezervasyon reklam öğeleri için rastgele alt alan adları kullanıp kullanmayacağı. Depolanan değeri temizlemek için
null
aktarın.
Not: Bu özellik varsayılan olarak etkindir. -
- Şunlara da bakabilirsiniz:
googletag.Service
Tüm hizmetler için ortak yöntemleri içeren temel hizmet sınıfı.
Yöntem Özeti | |
---|---|
addEventListener
|
Sayfada belirli bir GPT etkinliği meydana geldiğinde JavaScript işlevini ayarlamanıza ve çağırmanıza olanak tanıyan bir işleyici kaydeder.
|
getSlots
|
Bu hizmetle ilişkilendirilmiş slotların listesini alın.
|
removeEventListener
|
Önceden kaydedilmiş bir işleyiciyi kaldırır.
|
addEventListener
-
addEventListener<K extends keyof EventTypeMap>(eventType: K, listener: (arg: EventTypeMap[K]) => void): Service
-
Sayfada belirli bir GPT etkinliği meydana geldiğinde JavaScript işlevini ayarlamanıza ve çağırmanıza olanak tanıyan bir işleyici kaydeder. Aşağıdaki etkinlikler desteklenir:
Uygun etkinlik türüne sahip bir nesne, çağrıldığında işleyiciye iletilir. -
- Örnek
-
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 (eski)
// 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. } });
- Şunlara da bakabilirsiniz:
-
Parametreler eventType: K
GPT tarafından oluşturulan etkinliğin türünü temsil eden bir dize. Etkinlik türleri büyük/küçük harfe duyarlıdır.listener: (arg: EventTypeMap[K]) => void
Tek bir etkinlik nesnesi bağımsız değişkenini alan işlev. -
İlerlemeler Service
Yöntemin çağrıldığı hizmet nesnesi.
getSlots
removeEventListener
-
removeEventListener<K extends keyof EventTypeMap>(eventType: K, listener: (event: EventTypeMap[K]) => void): void
-
Önceden kaydedilmiş bir işleyiciyi kaldırır.
-
- Örnek
-
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 (eski)
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(); });
-
Parametreler eventType: K
GPT tarafından oluşturulan etkinliğin türünü temsil eden bir dize. Etkinlik türleri büyük/küçük harfe duyarlıdır.listener: (event: EventTypeMap[K]) => void
Tek bir etkinlik nesnesi bağımsız değişkenini alan işlev.
googletag.SizeMappingBuilder
Boyut eşleme spesifikasyonu nesneleri için oluşturucu. Bu oluşturucu, boyut özelliklerinin kolayca oluşturulmasına yardımcı olmak için sağlanmıştır.
Yöntem Özeti | |
---|---|
addSize
|
Tek boyutlu bir diziden (görüntü alanını temsil eden) alanı temsil eden tek veya çok boyutlu bir diziye eşleme ekler.
|
build
|
Bu oluşturucuya eklenen eşlemelerden boyut haritası spesifikasyonu oluşturur.
|
- Şunlara da bakabilirsiniz:
addSize
-
addSize(viewportSize: SingleSizeArray, slotSize: GeneralSize): SizeMappingBuilder
-
Tek boyutlu bir diziden (görüntü alanını temsil eden) alanı temsil eden tek veya çok boyutlu bir diziye eşleme ekler.
-
- Örnek
-
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 (eski)
// 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]
-
Parametreler viewportSize: SingleSizeArray
Bu eşleme girişi için görüntü alanının boyutu.slotSize: GeneralSize
Bu eşleme girişi için alanın boyutları. -
İlerlemeler SizeMappingBuilder
Bu derleyici için referans.
build
-
build(): null | SizeMappingArray
-
Bu oluşturucuya eklenen eşlemelerden boyut haritası spesifikasyonu oluşturur.
Geçersiz eşlemeler sağlandıysa bu yöntemnull
sonucunu döndürür. Aksi takdirde,Slot.defineSizeMapping
öğesine geçirmek için doğru biçimde bir spesifikasyon döndürür.
Not: Oluşturucunun bu yöntemi çağırdıktan sonraki davranışı tanımlanmamıştır. -
-
İlerlemeler null | SizeMappingArray
Bu oluşturucu tarafından oluşturulan sonuç. Geçersiz boyut eşlemeleri sağlandıysa null olabilir.
googletag.Slot
Alan, bir sayfadaki tek bir reklam alanını temsil eden bir nesnedir.
Yöntem Özeti | |
---|---|
addService
|
Bu alana
Service ekler.
|
clearCategoryExclusions
|
Bu alan için tüm alan düzeyinde reklam kategorisi hariç tutma etiketlerini temizler.
|
clearTargeting
|
Bu alan için belirli alan düzeyindeki veya tüm özel hedefleme parametrelerini temizler.
|
defineSizeMapping
|
Bu alan için minimum görüntü alanı boyutundan alan boyutuna bir eşleme dizisi ayarlar.
|
get
|
Bu alan için belirtilen anahtarla ilişkili AdSense özelliğinin değerini döndürür.
|
getAdUnitPath
|
Ağ kodu ve reklam birimi yoluyla birlikte reklam biriminin tam yolunu döndürür.
|
getAttributeKeys
|
Bu alanda ayarlanan özellik anahtarlarının listesini döndürür.
|
getCategoryExclusions
|
Bu alan için reklam kategorisi hariç tutma etiketlerini döndürür.
|
getResponseInformation
|
Reklam yanıtı bilgilerini döndürür.
|
getSlotElementId
|
Alan tanımlandığında sağlanan
div slotunun kimliğini döndürür.
|
getTargeting
|
Bu alanda ayarlanmış belirli bir özel hedefleme parametresi döndürür.
|
getTargetingKeys
|
Bu alanda ayarlanan tüm özel hedefleme anahtarlarının listesini döndürür.
|
set
|
Bu reklam alanındaki bir AdSense özelliği için bir değer ayarlar.
|
setCategoryExclusion
|
Bu alanda, alan düzeyinde bir reklam kategorisi hariç tutma etiketi ayarlar.
|
setClickUrl
|
Kullanıcıların reklamı tıkladıktan sonra yönlendirilecekleri tıklama URL'sini ayarlar.
|
setCollapseEmptyDiv
|
Alanda hiç reklam olmadığında
div alanının gizlenip gizlenmeyeceğini ayarlar.
|
setConfig
|
Bu yuva için genel yapılandırma seçeneklerini ayarlar.
|
setForceSafeFrame
|
Bu alandaki reklamların SafeFrame kapsayıcısı kullanılarak oluşturulmaya zorlanıp zorlanmayacağını yapılandırır.
|
setSafeFrameConfig
|
SafeFrame yapılandırması için alan düzeyinde tercihleri ayarlar.
|
setTargeting
|
Bu alan için özel hedefleme parametresi ayarlar.
|
updateTargetingFromMap
|
Bu alan için JSON nesnesindeki anahtar:değer eşlemesinden özel hedefleme parametreleri ayarlar.
|
addService
-
Bu alana
Service
ekler. -
- Örnek
-
JavaScript
googletag.defineSlot("/1234567/sports", [160, 600], "div").addService(googletag.pubads());
JavaScript (eski)
googletag.defineSlot("/1234567/sports", [160, 600], "div").addService(googletag.pubads());
TypeScript
googletag.defineSlot("/1234567/sports", [160, 600], "div")!.addService(googletag.pubads());
- Şunlara da bakabilirsiniz:
-
Parametreler service: Service
Eklenecek hizmet. -
İlerlemeler Slot
Yöntemin çağrıldığı slot nesnesi.
clearCategoryExclusions
-
clearCategoryExclusions(): Slot
-
Bu alan için tüm alan düzeyinde reklam kategorisi hariç tutma etiketlerini temizler.
-
- Örnek
-
JavaScript
// Set category exclusion to exclude ads with 'AirlineAd' labels. const slot = googletag .defineSlot("/1234567/sports", [160, 600], "div") .setCategoryExclusion("AirlineAd") .addService(googletag.pubads()); // Make an ad request. No ad with 'AirlineAd' label will be returned // for the slot. // Clear category exclusions so all ads can be returned. slot.clearCategoryExclusions(); // Make an ad request. Any ad can be returned for the slot.
JavaScript (eski)
// Set category exclusion to exclude ads with 'AirlineAd' labels. var slot = googletag .defineSlot("/1234567/sports", [160, 600], "div") .setCategoryExclusion("AirlineAd") .addService(googletag.pubads()); // Make an ad request. No ad with 'AirlineAd' label will be returned // for the slot. // Clear category exclusions so all ads can be returned. slot.clearCategoryExclusions(); // Make an ad request. Any ad can be returned for the slot.
TypeScript
// Set category exclusion to exclude ads with 'AirlineAd' labels. const slot = googletag .defineSlot("/1234567/sports", [160, 600], "div")! .setCategoryExclusion("AirlineAd") .addService(googletag.pubads()); // Make an ad request. No ad with 'AirlineAd' label will be returned // for the slot. // Clear category exclusions so all ads can be returned. slot.clearCategoryExclusions(); // Make an ad request. Any ad can be returned for the slot.
-
İlerlemeler Slot
Yöntemin çağrıldığı slot nesnesi.
clearTargeting
-
clearTargeting(key?: string): Slot
-
Bu alan için belirli alan düzeyindeki veya tüm özel hedefleme parametrelerini temizler.
-
- Örnek
-
JavaScript
const slot = googletag .defineSlot("/1234567/sports", [160, 600], "div") .setTargeting("allow_expandable", "true") .setTargeting("interests", ["sports", "music"]) .setTargeting("color", "red") .addService(googletag.pubads()); slot.clearTargeting("color"); // Targeting 'allow_expandable' and 'interests' are still present, // while 'color' was cleared. slot.clearTargeting(); // All targeting has been cleared.
JavaScript (eski)
var slot = googletag .defineSlot("/1234567/sports", [160, 600], "div") .setTargeting("allow_expandable", "true") .setTargeting("interests", ["sports", "music"]) .setTargeting("color", "red") .addService(googletag.pubads()); slot.clearTargeting("color"); // Targeting 'allow_expandable' and 'interests' are still present, // while 'color' was cleared. slot.clearTargeting(); // All targeting has been cleared.
TypeScript
const slot = googletag .defineSlot("/1234567/sports", [160, 600], "div")! .setTargeting("allow_expandable", "true") .setTargeting("interests", ["sports", "music"]) .setTargeting("color", "red") .addService(googletag.pubads()); slot.clearTargeting("color"); // Targeting 'allow_expandable' and 'interests' are still present, // while 'color' was cleared. slot.clearTargeting(); // All targeting has been cleared.
- Şunlara da bakabilirsiniz:
-
Parametreler key?: string
Hedefleme parametresi anahtarı. Anahtar isteğe bağlıdır. Belirtilmemişse tüm hedefleme parametreleri silinir. -
İlerlemeler Slot
Yöntemin çağrıldığı slot nesnesi.
defineSizeMapping
-
defineSizeMapping(sizeMapping: SizeMappingArray): Slot
-
Bu alan için minimum görüntü alanı boyutundan alan boyutuna bir eşleme dizisi ayarlar.
-
- Örnek
-
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 (eski)
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!);
- Şunlara da bakabilirsiniz:
-
Parametreler sizeMapping: SizeMappingArray
Boyut eşlemeleri dizisi. Oluşturmak içinSizeMappingBuilder
kullanabilirsiniz. Her boyut eşlemesi iki öğeden oluşan bir dizidir:SingleSizeArray
veGeneralSize
. -
İlerlemeler Slot
Yöntemin çağrıldığı slot nesnesi.
get
-
get(key: string): null | string
-
Bu alan için belirtilen anahtarla ilişkili AdSense özelliğinin değerini döndürür. Bu alan tarafından devralınan hizmet düzeyi özellikleri görmek için
PubAdsService.get
değerini kullanın. -
- Örnek
-
JavaScript
const slot = googletag .defineSlot("/1234567/sports", [160, 600], "div") .set("adsense_background_color", "#FFFFFF") .addService(googletag.pubads()); slot.get("adsense_background_color"); // Returns '#FFFFFF'.
JavaScript (eski)
var slot = googletag .defineSlot("/1234567/sports", [160, 600], "div") .set("adsense_background_color", "#FFFFFF") .addService(googletag.pubads()); slot.get("adsense_background_color"); // Returns '#FFFFFF'.
TypeScript
const slot = googletag .defineSlot("/1234567/sports", [160, 600], "div")! .set("adsense_background_color", "#FFFFFF") .addService(googletag.pubads()); slot.get("adsense_background_color"); // Returns '#FFFFFF'.
- Şunlara da bakabilirsiniz:
-
Parametreler key: string
Aranacak özelliğin adı. -
İlerlemeler null | string
Özellik anahtarı için geçerli değer veya anahtar yoksanull
.
getAdUnitPath
-
getAdUnitPath(): string
-
Ağ kodu ve reklam birimi yoluyla birlikte reklam biriminin tam yolunu döndürür.
-
- Örnek
-
JavaScript
const slot = googletag .defineSlot("/1234567/sports", [160, 600], "div") .addService(googletag.pubads()); slot.getAdUnitPath(); // Returns '/1234567/sports'.
JavaScript (eski)
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'.
-
İlerlemeler string
Reklam birimi yolu.
getAttributeKeys
-
getAttributeKeys(): string[]
-
Bu alanda ayarlanan özellik anahtarlarının listesini döndürür. Bu alan tarafından devralınan hizmet düzeyi özelliklerin anahtarlarını görmek için
PubAdsService.getAttributeKeys
değerini kullanın. -
- Örnek
-
JavaScript
const slot = googletag .defineSlot("/1234567/sports", [160, 600], "div") .set("adsense_background_color", "#FFFFFF") .set("adsense_border_color", "#AABBCC") .addService(googletag.pubads()); slot.getAttributeKeys(); // Returns ['adsense_background_color', 'adsense_border_color'].
JavaScript (eski)
var slot = googletag .defineSlot("/1234567/sports", [160, 600], "div") .set("adsense_background_color", "#FFFFFF") .set("adsense_border_color", "#AABBCC") .addService(googletag.pubads()); slot.getAttributeKeys(); // Returns ['adsense_background_color', 'adsense_border_color'].
TypeScript
const slot = googletag .defineSlot("/1234567/sports", [160, 600], "div")! .set("adsense_background_color", "#FFFFFF") .set("adsense_border_color", "#AABBCC") .addService(googletag.pubads()); slot.getAttributeKeys(); // Returns ['adsense_background_color', 'adsense_border_color'].
-
İlerlemeler string[]
Özellik anahtarları dizisi. Sıralama tanımsız.
getCategoryExclusions
-
getCategoryExclusions(): string[]
-
Bu alan için reklam kategorisi hariç tutma etiketlerini döndürür.
-
- Örnek
-
JavaScript
const slot = googletag .defineSlot("/1234567/sports", [160, 600], "div") .setCategoryExclusion("AirlineAd") .setCategoryExclusion("TrainAd") .addService(googletag.pubads()); slot.getCategoryExclusions(); // Returns ['AirlineAd', 'TrainAd'].
JavaScript (eski)
var slot = googletag .defineSlot("/1234567/sports", [160, 600], "div") .setCategoryExclusion("AirlineAd") .setCategoryExclusion("TrainAd") .addService(googletag.pubads()); slot.getCategoryExclusions(); // Returns ['AirlineAd', 'TrainAd'].
TypeScript
const slot = googletag .defineSlot("/1234567/sports", [160, 600], "div")! .setCategoryExclusion("AirlineAd") .setCategoryExclusion("TrainAd") .addService(googletag.pubads()); slot.getCategoryExclusions(); // Returns ['AirlineAd', 'TrainAd'].
-
İlerlemeler string[]
Bu alan için reklam kategorisi hariç tutma etiketleri veya hiç ayarlanmamışsa boş dizi.
getResponseInformation
-
getResponseInformation(): null | ResponseInformation
-
Reklam yanıtı bilgilerini döndürür. Bu, alanın son reklam yanıtına dayanır. Bu çağrı, alanda hiç reklam olmadığında çağrılırsa
null
döndürülür. -
-
İlerlemeler null | ResponseInformation
En son reklam yanıtı bilgileri veya alanda reklam yoksanull
.
getSlotElementId
-
getSlotElementId(): string
-
Alan tanımlandığında sağlanan
div
slotunun kimliğini döndürür. -
- Örnek
-
JavaScript
const slot = googletag .defineSlot("/1234567/sports", [160, 600], "div") .addService(googletag.pubads()); slot.getSlotElementId(); // Returns 'div'.
JavaScript (eski)
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'.
-
İlerlemeler string
Alandiv
Kimliği.
getTargeting
-
getTargeting(key: string): string[]
-
Bu alanda ayarlanmış belirli bir özel hedefleme parametresi döndürür. Hizmet düzeyinde hedefleme parametreleri dahil değildir.
-
- Örnek
-
JavaScript
const slot = googletag .defineSlot("/1234567/sports", [160, 600], "div") .setTargeting("allow_expandable", "true") .addService(googletag.pubads()); slot.getTargeting("allow_expandable"); // Returns ['true']. slot.getTargeting("age"); // Returns [] (empty array).
JavaScript (eski)
var slot = googletag .defineSlot("/1234567/sports", [160, 600], "div") .setTargeting("allow_expandable", "true") .addService(googletag.pubads()); slot.getTargeting("allow_expandable"); // Returns ['true']. slot.getTargeting("age"); // Returns [] (empty array).
TypeScript
const slot = googletag .defineSlot("/1234567/sports", [160, 600], "div")! .setTargeting("allow_expandable", "true") .addService(googletag.pubads()); slot.getTargeting("allow_expandable"); // Returns ['true']. slot.getTargeting("age"); // Returns [] (empty array).
-
Parametreler key: string
Aranacak hedefleme anahtarı. -
İlerlemeler string[]
Bu anahtarla ilişkilendirilen değerler veya böyle bir anahtar yoksa boş dizi.
getTargetingKeys
-
getTargetingKeys(): string[]
-
Bu alanda ayarlanan tüm özel hedefleme anahtarlarının listesini döndürür. Hizmet düzeyinde hedefleme anahtarları dahil değildir.
-
- Örnek
-
JavaScript
const slot = googletag .defineSlot("/1234567/sports", [160, 600], "div") .setTargeting("allow_expandable", "true") .setTargeting("interests", ["sports", "music"]) .addService(googletag.pubads()); slot.getTargetingKeys(); // Returns ['interests', 'allow_expandable'].
JavaScript (eski)
var slot = googletag .defineSlot("/1234567/sports", [160, 600], "div") .setTargeting("allow_expandable", "true") .setTargeting("interests", ["sports", "music"]) .addService(googletag.pubads()); slot.getTargetingKeys(); // Returns ['interests', 'allow_expandable'].
TypeScript
const slot = googletag .defineSlot("/1234567/sports", [160, 600], "div")! .setTargeting("allow_expandable", "true") .setTargeting("interests", ["sports", "music"]) .addService(googletag.pubads()); slot.getTargetingKeys(); // Returns ['interests', 'allow_expandable'].
-
İlerlemeler string[]
Hedefleme anahtarları dizisi. Sıralama tanımsız.
set
-
set(key: string, value: string): Slot
-
Bu reklam alanındaki bir AdSense özelliği için bir değer ayarlar. Bu işlem, bu anahtar için hizmet düzeyinde ayarlanmış tüm değerleri geçersiz kılar.
Bu yöntemin aynı anahtar için birden fazla kez çağrılması, söz konusu anahtar için daha önce ayarlanmış olan değerleri geçersiz kılar.display
veyarefresh
çağrılmadan önce tüm değerler ayarlanmalıdır. -
- Örnek
-
JavaScript
// Setting an attribute on a single ad slot. googletag .defineSlot("/1234567/sports", [160, 600], "div") .set("adsense_background_color", "#FFFFFF") .addService(googletag.pubads());
JavaScript (eski)
// Setting an attribute on a single ad slot. googletag .defineSlot("/1234567/sports", [160, 600], "div") .set("adsense_background_color", "#FFFFFF") .addService(googletag.pubads());
TypeScript
// Setting an attribute on a single ad slot. googletag .defineSlot("/1234567/sports", [160, 600], "div")! .set("adsense_background_color", "#FFFFFF") .addService(googletag.pubads());
- Şunlara da bakabilirsiniz:
-
Parametreler key: string
Özelliğin adı.value: string
Özellik değeri. -
İlerlemeler Slot
Yöntemin çağrıldığı slot nesnesi.
setCategoryExclusion
-
setCategoryExclusion(categoryExclusion: string): Slot
-
Bu alanda, alan düzeyinde bir reklam kategorisi hariç tutma etiketi ayarlar.
-
- Örnek
-
JavaScript
// Label = AirlineAd googletag .defineSlot("/1234567/sports", [160, 600], "div") .setCategoryExclusion("AirlineAd") .addService(googletag.pubads());
JavaScript (eski)
// Label = AirlineAd googletag .defineSlot("/1234567/sports", [160, 600], "div") .setCategoryExclusion("AirlineAd") .addService(googletag.pubads());
TypeScript
// Label = AirlineAd googletag .defineSlot("/1234567/sports", [160, 600], "div")! .setCategoryExclusion("AirlineAd") .addService(googletag.pubads());
- Şunlara da bakabilirsiniz:
-
Parametreler categoryExclusion: string
Eklenecek reklam kategorisi hariç tutma etiketi. -
İlerlemeler Slot
Yöntemin çağrıldığı slot nesnesi.
setClickUrl
-
setClickUrl(value: string): Slot
-
Reklamı tıklayan kullanıcıların yönlendirileceği tıklama URL'sini belirler.
Google Ad Manager sunucuları, tıklama URL'si değiştirilse bile tıklamayı kaydetmeye devam eder. Sunulan reklam öğesiyle ilişkili herhangi bir açılış sayfası URL'si, sağlanan değere eklenir. Sonraki çağrılar bu değerin üzerine yazılır. Bu, yalnızca SRA olmayan istekler için çalışır. -
- Örnek
-
JavaScript
googletag .defineSlot("/1234567/sports", [160, 600], "div") .setClickUrl("http://www.example.com?original_click_url=") .addService(googletag.pubads());
JavaScript (eski)
googletag .defineSlot("/1234567/sports", [160, 600], "div") .setClickUrl("http://www.example.com?original_click_url=") .addService(googletag.pubads());
TypeScript
googletag .defineSlot("/1234567/sports", [160, 600], "div")! .setClickUrl("http://www.example.com?original_click_url=") .addService(googletag.pubads());
-
Parametreler value: string
Ayarlanacak tıklama URL'si. -
İlerlemeler Slot
Yöntemin çağrıldığı slot nesnesi.
setCollapseEmptyDiv
-
setCollapseEmptyDiv(collapse: boolean, collapseBeforeAdFetch?: boolean): Slot
-
Alanda hiç reklam olmadığında
div
alanının gizlenip gizlenmeyeceğini ayarlar. Bu, hizmet düzeyindeki ayarları geçersiz kılar. -
- Örnek
-
JavaScript
googletag .defineSlot("/1234567/sports", [160, 600], "div-1") .setCollapseEmptyDiv(true, true) .addService(googletag.pubads()); // The above will cause the div for this slot to be collapsed // when the page is loaded, before ads are requested. googletag .defineSlot("/1234567/sports", [160, 600], "div-2") .setCollapseEmptyDiv(true) .addService(googletag.pubads()); // The above will cause the div for this slot to be collapsed // only after GPT detects that no ads are available for the slot.
JavaScript (eski)
googletag .defineSlot("/1234567/sports", [160, 600], "div-1") .setCollapseEmptyDiv(true, true) .addService(googletag.pubads()); // The above will cause the div for this slot to be collapsed // when the page is loaded, before ads are requested. googletag .defineSlot("/1234567/sports", [160, 600], "div-2") .setCollapseEmptyDiv(true) .addService(googletag.pubads()); // The above will cause the div for this slot to be collapsed // only after GPT detects that no ads are available for the slot.
TypeScript
googletag .defineSlot("/1234567/sports", [160, 600], "div-1")! .setCollapseEmptyDiv(true, true) .addService(googletag.pubads()); // The above will cause the div for this slot to be collapsed // when the page is loaded, before ads are requested. googletag .defineSlot("/1234567/sports", [160, 600], "div-2")! .setCollapseEmptyDiv(true) .addService(googletag.pubads()); // The above will cause the div for this slot to be collapsed // only after GPT detects that no ads are available for the slot.
- Şunlara da bakabilirsiniz:
-
Parametreler collapse: boolean
Hiçbir reklam döndürülmezse alanın daraltılıp daraltılmayacağını belirler.collapseBeforeAdFetch?: boolean
Reklam getirilmeden önce bile alanın daraltılıp daraltılmayacağını belirler. Daraltmatrue
değilse yoksayılır. -
İlerlemeler Slot
Yöntemin çağrıldığı slot nesnesi.
setConfig
-
setConfig(slotConfig: SlotSettingsConfig): void
-
Bu yuva için genel yapılandırma seçeneklerini ayarlar.
-
-
Parametreler slotConfig: SlotSettingsConfig
Yapılandırma nesnesi.
setForceSafeFrame
-
setForceSafeFrame(forceSafeFrame: boolean): Slot
-
Bu alandaki reklamların SafeFrame kapsayıcısı kullanılarak oluşturulmaya zorlanıp zorlanmayacağını yapılandırır.
Bu API'yi kullanırken lütfen aşağıdakileri göz önünde bulundurun:- Bu ayar, yalnızca ilgili alanlar için yapılmış sonraki reklam isteklerinde geçerli olur.
- Alan seviyesindeki ayar (belirtilmişse) sayfa düzeyindeki ayarı her zaman geçersiz kılar.
true
olarak ayarlanırsa (alan düzeyinde veya sayfa düzeyinde) reklam, Google Ad Manager kullanıcı arayüzünde yapılan seçimden bağımsız olarak her zaman bir SafeFrame kapsayıcısı kullanılarak oluşturulur.- Ancak
false
olarak ayarlanırsa veya belirtilmemişse reklam, reklam öğesinin türüne ve Google Ad Manager kullanıcı arayüzünde yapılan seçime bağlı olarak bir SafeFrame kapsayıcısı kullanılarak oluşturulur. - Bu API, iFrame'lerini çıkarmaya çalışan veya doğrudan bir yayıncı sayfasında oluşturulmasına güvenen reklam öğelerinin davranışını etkileyebileceği için dikkatli kullanılmalıdır.
-
- Örnek
-
JavaScript
googletag .defineSlot("/1234567/sports", [160, 600], "div") .setForceSafeFrame(true) .addService(googletag.pubads());
JavaScript (eski)
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());
- Şunlara da bakabilirsiniz:
-
Parametreler forceSafeFrame: boolean
Bu alandaki tüm reklamları SafeFrame'lerde oluşturulmaya zorlamak içintrue
ve sayfa düzeyindeki bir ayarın (varsa) kapsamı dışında kalmayı seçmek içinfalse
. Sayfa düzeyinde belirtilmediğinde bu ayarınfalse
olarak ayarlanması hiçbir şeyi değiştirmez. -
İlerlemeler Slot
Yöntemin çağrıldığı slot nesnesi.
setSafeFrameConfig
-
setSafeFrameConfig(config: null | SafeFrameConfig): Slot
-
SafeFrame yapılandırması için alan düzeyinde tercihleri ayarlar. Yapılandırma nesnesindeki tanınmayan anahtarlar yoksayılır. Tanınan bir anahtar için geçersiz bir değer aktarılırsa yapılandırmanın tamamı yoksayılır.
Bu alan düzeyindeki tercihler, belirtilirse sayfa düzeyindeki tüm tercihleri geçersiz kılar. -
- Örnek
-
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 (eski)
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");
- Şunlara da bakabilirsiniz:
-
Parametreler config: null | SafeFrameConfig
Yapılandırma nesnesi. -
İlerlemeler Slot
Yöntemin çağrıldığı slot nesnesi.
setTargeting
-
setTargeting(key: string, value: string | string[]): Slot
-
Bu alan için özel hedefleme parametresi ayarlar. Bu yöntemin aynı anahtar için birden çok kez çağrılması, eski değerlerin üzerine yazılmasına neden olur. Burada ayarlanan değerler, hizmet düzeyinde belirlenen hedefleme parametrelerinin üzerine yazılır. Bu anahtarlar Google Ad Manager hesabınızda tanımlanır.
-
- Örnek
-
JavaScript
const slot = googletag .defineSlot("/1234567/sports", [160, 600], "div") .addService(googletag.pubads()); // Example with a single value for a key. slot.setTargeting("allow_expandable", "true"); // Example with multiple values for a key inside in an array. slot.setTargeting("interests", ["sports", "music"]);
JavaScript (eski)
var slot = googletag .defineSlot("/1234567/sports", [160, 600], "div") .addService(googletag.pubads()); // Example with a single value for a key. slot.setTargeting("allow_expandable", "true"); // Example with multiple values for a key inside in an array. slot.setTargeting("interests", ["sports", "music"]);
TypeScript
const slot = googletag .defineSlot("/1234567/sports", [160, 600], "div")! .addService(googletag.pubads()); // Example with a single value for a key. slot.setTargeting("allow_expandable", "true"); // Example with multiple values for a key inside in an array. slot.setTargeting("interests", ["sports", "music"]);
- Şunlara da bakabilirsiniz:
-
Parametreler key: string
Hedefleme parametresi anahtarı.value: string | string[]
Hedefleme parametresi değeri veya değer dizisi. -
İlerlemeler Slot
Yöntemin çağrıldığı slot nesnesi.
updateTargetingFromMap
-
updateTargetingFromMap(map: { [adUnitPath: string]: string | string[] }): Slot
-
Bu alan için JSON nesnesindeki anahtar:değer eşlemesinden özel hedefleme parametreleri ayarlar. Bu, nesnenin tüm anahtar değerleri için
Slot.setTargeting
yönteminin çağrılmasıyla aynıdır. Bu anahtarlar, Google Ad Manager hesabınızda tanımlanır.
Notlar:- Üzerine yazma durumunda yalnızca son değer korunur.
- Değer bir diziyse önceki değerlerin üzerine yazılır, birleştirilmez.
- Burada ayarlanan değerler, hizmet düzeyinde belirlenen hedefleme parametrelerinin üzerine yazılır.
-
- Örnek
-
JavaScript
const slot = googletag.defineSlot("/1234567/sports", [160, 600], "div"); slot.updateTargetingFromMap({ color: "red", interests: ["sports", "music", "movies"], });
JavaScript (eski)
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"], });
-
Parametreler map: { [adUnitPath: string]: string | string[] }
Hedefleme parametresi anahtar/değer eşlemesi. -
İlerlemeler Slot
Yöntemin çağrıldığı slot nesnesi.
googletag.config.AdExpansionConfig
Reklam genişletmeyi kontrol etmek için ayarlar.
Mülk Özeti | |
---|---|
enabled
|
Reklam genişletmenin etkin veya devre dışı olup olmadığı.
|
- Örnek
-
JavaScript
// Enable ad slot expansion across the entire page. googletag.setConfig({ adExpansion: { enabled: true }, });
JavaScript (eski)
// Enable ad slot expansion across the entire page. googletag.setConfig({ adExpansion: { enabled: true }, });
TypeScript
// Enable ad slot expansion across the entire page. googletag.setConfig({ adExpansion: { enabled: true }, });
enabled
-
enabled: boolean
-
Reklam genişletmenin etkin mi yoksa devre dışı mı olduğu.
Bu değerin ayarlanması, Google Ad Manager'da yapılandırılan varsayılan değeri geçersiz kılar. -
- Şunlara da bakabilirsiniz:
googletag.config.ComponentAuctionConfig
Cihaz üzerinde reklam açık artırmasında tek bileşenli bir açık artırmayı temsil eden nesne.
Mülk Özeti | |
---|---|
auctionConfig
|
Bu bileşen açık artırması için bir açık artırma yapılandırma nesnesi.
|
configKey
|
Bu bileşen açık artırmasıyla ilişkili yapılandırma anahtarı.
|
- Şunlara da bakabilirsiniz:
auctionConfig
-
auctionConfig: null | { auctionSignals: unknown, decisionLogicUrl: string, interestGroupBuyers: string[], perBuyerExperimentGroupIds: { [buyer: string]: number }, perBuyerGroupLimits: { [buyer: string]: number }, perBuyerSignals: { [buyer: string]: unknown }, perBuyerTimeouts: { [buyer: string]: number }, seller: string, sellerExperimentGroupId: number, sellerSignals: unknown, sellerTimeout: number, trustedScoringSignalsUrl: string }
-
Bu bileşen açık artırması için bir açık artırma yapılandırma nesnesi.
Bu değernull
olarak ayarlanırsa, belirtilenconfigKey
için mevcut yapılandırmalar silinir. -
- Örnek
-
JavaScript
const componentAuctionConfig = { // Seller URL should be https and the same as decisionLogicUrl's origin seller: "https://testSeller.com", decisionLogicUrl: "https://testSeller.com/ssp/decision-logic.js", interestGroupBuyers: ["https://example-buyer.com"], auctionSignals: { auction_signals: "auction_signals" }, sellerSignals: { seller_signals: "seller_signals" }, perBuyerSignals: { // listed on interestGroupBuyers "https://example-buyer.com": { per_buyer_signals: "per_buyer_signals", }, }, }; const auctionSlot = googletag.defineSlot("/1234567/example", [160, 600]); // To add configKey to the component auction: auctionSlot.setConfig({ componentAuction: [ { configKey: "https://testSeller.com", auctionConfig: componentAuctionConfig, }, ], }); // To remove configKey from the component auction: auctionSlot.setConfig({ componentAuction: [ { configKey: "https://testSeller.com", auctionConfig: null, }, ], });
JavaScript (eski)
var componentAuctionConfig = { // Seller URL should be https and the same as decisionLogicUrl's origin seller: "https://testSeller.com", decisionLogicUrl: "https://testSeller.com/ssp/decision-logic.js", interestGroupBuyers: ["https://example-buyer.com"], auctionSignals: { auction_signals: "auction_signals" }, sellerSignals: { seller_signals: "seller_signals" }, perBuyerSignals: { // listed on interestGroupBuyers "https://example-buyer.com": { per_buyer_signals: "per_buyer_signals", }, }, }; var auctionSlot = googletag.defineSlot("/1234567/example", [160, 600]); // To add configKey to the component auction: auctionSlot.setConfig({ componentAuction: [ { configKey: "https://testSeller.com", auctionConfig: componentAuctionConfig, }, ], }); // To remove configKey from the component auction: auctionSlot.setConfig({ componentAuction: [ { configKey: "https://testSeller.com", auctionConfig: null, }, ], });
TypeScript
const componentAuctionConfig = { // Seller URL should be https and the same as decisionLogicUrl's origin seller: "https://testSeller.com", decisionLogicUrl: "https://testSeller.com/ssp/decision-logic.js", interestGroupBuyers: ["https://example-buyer.com"], auctionSignals: { auction_signals: "auction_signals" }, sellerSignals: { seller_signals: "seller_signals" }, perBuyerSignals: { // listed on interestGroupBuyers "https://example-buyer.com": { per_buyer_signals: "per_buyer_signals", }, }, }; const auctionSlot = googletag.defineSlot("/1234567/example", [160, 600])!; // To add configKey to the component auction: auctionSlot.setConfig({ componentAuction: [ { configKey: "https://testSeller.com", auctionConfig: componentAuctionConfig, }, ], }); // To remove configKey from the component auction: auctionSlot.setConfig({ componentAuction: [ { configKey: "https://testSeller.com", auctionConfig: null, }, ], });
- Şunlara da bakabilirsiniz:
configKey
-
configKey: string
-
Bu bileşen açık artırmasıyla ilişkili yapılandırma anahtarı.
Bu değer boş olmamalı ve benzersiz olmalıdır. İkiComponentAuctionConfig
nesnesi aynı configKey değerini paylaşırsa ayarlanacak son nesne önceki yapılandırmaların üzerine yazılır. -
googletag.config.InterstitialConfig
Tek bir geçiş reklamı alanının davranışını tanımlayan bir nesne.
Mülk Özeti | |
---|---|
triggers
|
Bu geçiş reklamı için geçiş reklamı tetikleyici yapılandırması.
|
triggers
-
triggers: Partial<Record<InterstitialTrigger, boolean>>
-
Bu geçiş reklamı için geçiş reklamı tetikleyici yapılandırması.
Geçiş reklamı tetikleyicisinin değeritrue
olarak ayarlanırsa geçiş reklamı etkinleştirilir vefalse
devre dışı bırakılır. Bu, Google Ad Manager'da yapılandırılan varsayılan değerleri geçersiz kılar. -
- Örnek
-
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 (eski)
// 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, }, }, });
- Şunlara da bakabilirsiniz:
googletag.config.PageSettingsConfig
Sayfa düzeyinde ayarlar için ana yapılandırma arayüzü.
Tek bir API çağrısıyla birden fazla özelliğin ayarlanmasına olanak tanır.
Aşağıda listelenen tüm özellikler örnektir ve setConfig kullanan gerçek özellikleri yansıtmaz. Özellik grubu için aşağıdaki PageSettingsConfig türündeki alanlara bakın.
Örnekler:
- Yalnızca
setConfig
çağrısında belirtilen özellikler değiştirilir.// Configure feature alpha. googletag.setConfig({ alpha: {...} }); // Configure feature bravo. Feature alpha is unchanged. googletag.setConfig({ bravo: {...} });
- Belirli bir özelliğin tüm ayarları,
setConfig
'e yapılan her çağrıyla güncellenir.// 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 } });
- Bir özelliğin tüm ayarları
null
geçilerek temizlenebilir.// 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, });
Mülk Özeti | |
---|---|
adExpansion
|
Reklam genişletmeyi kontrol etmek için ayarlar.
|
pps
|
Yayıncı tarafından sağlanan sinyalleri (PPS) kontrol eden ayarlar.
|
privacyTreatments
|
Yayıncı gizlilik işlemlerini kontrol etmek için ayarlar.
|
adExpansion
-
adExpansion: null | AdExpansionConfig
-
Reklam genişletmeyi kontrol etmek için ayarlar.
-
pps
-
pps: null | PublisherProvidedSignalsConfig
-
Yayıncı tarafından sağlanan sinyalleri (PPS) kontrol eden ayarlar.
-
privacyTreatments
-
privacyTreatments: null | PrivacyTreatmentsConfig
-
Yayıncı gizlilik işlemlerini kontrol etmek için ayarlar.
-
googletag.config.PrivacyTreatmentsConfig
Yayıncı gizlilik işlemlerini kontrol etmek için ayarlar.
Mülk Özeti | |
---|---|
treatments
|
Yayıncıların etkinleştirebileceği bir dizi gizlilik işlemi.
|
treatments
-
treatments: "disablePersonalization"[]
-
Yayıncıların etkinleştirebileceği bir dizi gizlilik işlemi.
-
- Örnek
-
JavaScript
// Disable personalization across the entire page. googletag.setConfig({ privacyTreatments: { treatments: ["disablePersonalization"] }, });
JavaScript (eski)
// 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
Yayıncı tarafından sağlanan sinyaller (PPS) yapılandırma nesnesi.
Mülk Özeti | |
---|---|
taxonomies
|
Sınıflandırma eşlemelerini içeren bir nesne.
|
- Örnek
-
JavaScript
googletag.setConfig({ pps: { taxonomies: { IAB_AUDIENCE_1_1: { values: ["6", "626"] }, // '6' = 'Demographic | Age Range | 18-20' // '626' = 'Interest | Sports | Darts' IAB_CONTENT_2_2: { values: ["48", "127"] }, // '48' = 'Books and Literature | Fiction' // '127' = 'Careers | Job Search' }, }, });
JavaScript (eski)
googletag.setConfig({ pps: { taxonomies: { IAB_AUDIENCE_1_1: { values: ["6", "626"] }, // '6' = 'Demographic | Age Range | 18-20' // '626' = 'Interest | Sports | Darts' IAB_CONTENT_2_2: { values: ["48", "127"] }, // '48' = 'Books and Literature | Fiction' // '127' = 'Careers | Job Search' }, }, });
TypeScript
googletag.setConfig({ pps: { taxonomies: { IAB_AUDIENCE_1_1: { values: ["6", "626"] }, // '6' = 'Demographic | Age Range | 18-20' // '626' = 'Interest | Sports | Darts' IAB_CONTENT_2_2: { values: ["48", "127"] }, // '48' = 'Books and Literature | Fiction' // '127' = 'Careers | Job Search' }, }, });
- Şunlara da bakabilirsiniz:
taxonomies
-
taxonomies: Partial<Record<Taxonomy, TaxonomyData>>
-
Sınıflandırma eşlemelerini içeren bir nesne.
-
googletag.config.SlotSettingsConfig
Slot seviyesinde ayarlar için ana yapılandırma arayüzü.
Tek bir slot için tek bir API çağrısıyla birden fazla özelliğin ayarlanmasına olanak tanır.
Aşağıda listelenen tüm özellikler örnektir ve setConfig kullanan gerçek özellikleri yansıtmaz. Özellik grubu için aşağıdaki SlotSettingsConfig türündeki alanlara bakın.
Örnekler:
- Yalnızca
Slot.setConfig
çağrısında belirtilen özellikler değiştirilir.const slot = googletag.defineSlot("/1234567/example", [160, 600]); // Configure feature alpha. slot.setConfig({ alpha: {...} }); // Configure feature bravo. Feature alpha is unchanged. slot.setConfig({ bravo: {...} });
- Belirli bir özelliğin tüm ayarları,
Slot.setConfig
'e yapılan her çağrıyla güncellenir.// 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 } });
- Bir özelliğin tüm ayarları
null
geçilerek temizlenebilir.// 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, });
Mülk Özeti | |
---|---|
adExpansion
|
Reklam genişletmeyi kontrol etmek için ayarlar.
|
componentAuction
|
Cihaz üzerinde reklam açık artırmasına dahil edilecek bileşen açık artırmaları dizisi.
|
interstitial
|
Geçiş reklamı alanı davranışını kontrol eden ayarlar.
|
adExpansion
-
adExpansion: AdExpansionConfig
-
Reklam genişletmeyi kontrol etmek için ayarlar.
-
componentAuction
-
componentAuction: ComponentAuctionConfig[]
-
Cihaz üzerinde reklam açık artırmasına dahil edilecek bileşen açık artırmaları dizisi.
-
interstitial
-
interstitial: InterstitialConfig
-
Geçiş reklamı alanı davranışını kontrol eden ayarlar.
-
googletag.config.TaxonomyData
Tek bir Sınıflandırma'ya ait değerleri içeren nesne.
Mülk Özeti | |
---|---|
values
|
Sınıflandırma değerlerinin listesi.
|
values
-
values: string[]
-
Sınıflandırma değerlerinin listesi.
-
googletag.events.Event
Tüm GPT etkinlikleri için Temel Arayüz. Aşağıdaki tüm GPT etkinliklerinde aşağıdaki alanlar bulunur.
Mülk Özeti | |
---|---|
serviceName
|
Etkinliği tetikleyen hizmetin adı.
|
slot
|
Etkinliği tetikleyen zaman aralığı.
|
- Şunlara da bakabilirsiniz:
serviceName
-
serviceName: string
-
Etkinliği tetikleyen hizmetin adı.
-
slot
-
slot: Slot
-
Etkinliği tetikleyen zaman aralığı.
-
googletag.events.EventTypeMap
Bu, bir etkinlik adını Service.addEventListener
ve Service.removeEventListener
için karşılık gelen etkinlik nesnesi türüyle eşleyen bir sözde türdür. Yalnızca referans ve tür güvenliği için belgelenmiştir.
Mülk Özeti | |
---|---|
impressionViewable
|
events.ImpressionViewableEvent için takma ad.
|
rewardedSlotClosed
|
events.RewardedSlotClosedEvent için takma ad.
|
rewardedSlotGranted
|
events.RewardedSlotGrantedEvent için takma ad.
|
rewardedSlotReady
|
events.RewardedSlotReadyEvent için takma ad.
|
slotOnload
|
events.SlotOnloadEvent için takma ad.
|
slotRenderEnded
|
events.SlotRenderEndedEvent için takma ad.
|
slotRequested
|
events.SlotRequestedEvent için takma ad.
|
slotResponseReceived
|
events.SlotResponseReceived için takma ad.
|
slotVisibilityChanged
|
events.SlotVisibilityChangedEvent için takma ad.
|
impressionViewable
-
impressionViewable: ImpressionViewableEvent
-
events.ImpressionViewableEvent
için takma ad. -
rewardedSlotClosed
-
rewardedSlotClosed: RewardedSlotClosedEvent
-
events.RewardedSlotClosedEvent
için takma ad. -
rewardedSlotGranted
-
rewardedSlotGranted: RewardedSlotGrantedEvent
-
events.RewardedSlotGrantedEvent
için takma ad. -
rewardedSlotReady
-
rewardedSlotReady: RewardedSlotReadyEvent
-
events.RewardedSlotReadyEvent
için takma ad. -
slotOnload
-
slotOnload: SlotOnloadEvent
-
events.SlotOnloadEvent
için takma ad. -
slotRenderEnded
-
slotRenderEnded: SlotRenderEndedEvent
-
events.SlotRenderEndedEvent
için takma ad. -
slotRequested
-
slotRequested: SlotRequestedEvent
-
events.SlotRequestedEvent
için takma ad. -
slotResponseReceived
-
slotResponseReceived: SlotResponseReceived
-
events.SlotResponseReceived
için takma ad. -
slotVisibilityChanged
-
slotVisibilityChanged: SlotVisibilityChangedEvent
-
events.SlotVisibilityChangedEvent
için takma ad. -
googletag.events.ImpressionViewableEvent
Uzatmalar
Bu etkinlik, Aktif Görüntüleme ölçütlerine göre bir gösterim görüntülenebilir olduğunda tetiklenir.
Mülk Özeti | |
---|---|
serviceName
|
Etkinliği tetikleyen hizmetin adı.
Şu kuruluş biriminden devralındı:
|
slot
|
Etkinliği tetikleyen zaman aralığı.
Şu kuruluş biriminden devralındı:
|
- Örnek
-
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 (eski)
// 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. } });
- Şunlara da bakabilirsiniz:
googletag.events.RewardedSlotClosedEvent
Uzatmalar
Bu etkinlik, ödüllü reklam alanı kullanıcı tarafından kapatıldığında tetiklenir. Ödül verilmeden önce veya ödül verildikten sonra etkinleşebilir. Bir ödülün verilip verilmediğini belirlemek için bunun yerine events.RewardedSlotGrantedEvent
değerini kullanın.
Mülk Özeti | |
---|---|
serviceName
|
Etkinliği tetikleyen hizmetin adı.
Şu kuruluş biriminden devralındı:
|
slot
|
Etkinliği tetikleyen zaman aralığı.
Şu kuruluş biriminden devralındı:
|
- Örnek
-
JavaScript
// This listener is called when the user closes a rewarded ad slot. const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]); googletag.pubads().addEventListener("rewardedSlotClosed", (event) => { const slot = event.slot; console.log("Rewarded ad slot", slot.getSlotElementId(), "has been closed."); if (slot === targetSlot) { // Slot specific logic. } });
JavaScript (eski)
// This listener is called when the user closes a rewarded ad slot. var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]); googletag.pubads().addEventListener("rewardedSlotClosed", function (event) { var slot = event.slot; console.log("Rewarded ad slot", slot.getSlotElementId(), "has been closed."); if (slot === targetSlot) { // Slot specific logic. } });
TypeScript
// This listener is called when the user closes a rewarded ad slot. const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]); googletag.pubads().addEventListener("rewardedSlotClosed", (event) => { const slot = event.slot; console.log("Rewarded ad slot", slot.getSlotElementId(), "has been closed."); if (slot === targetSlot) { // Slot specific logic. } });
- Şunlara da bakabilirsiniz:
googletag.events.RewardedSlotGrantedEvent
Uzatmalar
Bu etkinlik, ödüllü bir reklamın görüntülenmesi karşılığında bir ödül verildiğinde tetiklenir. Reklam, ödül verme ölçütleri karşılanmadan önce kapatılırsa bu etkinlik tetiklenmez.
Mülk Özeti | |
---|---|
payload
|
Verilen ödülle ilgili bilgileri içeren bir nesne.
|
serviceName
|
Etkinliği tetikleyen hizmetin adı.
Şu kuruluş biriminden devralındı:
|
slot
|
Etkinliği tetikleyen zaman aralığı.
Şu kuruluş biriminden devralındı:
|
- Örnek
-
JavaScript
// This listener is called whenever a reward is granted for a // rewarded ad. const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]); googletag.pubads().addEventListener("rewardedSlotGranted", (event) => { const slot = event.slot; console.group("Reward granted for slot", slot.getSlotElementId(), "."); // Log details of the reward. console.log("Reward type:", event.payload?.type); console.log("Reward amount:", event.payload?.amount); console.groupEnd(); if (slot === targetSlot) { // Slot specific logic. } });
JavaScript (eski)
// This listener is called whenever a reward is granted for a // rewarded ad. var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]); googletag.pubads().addEventListener("rewardedSlotGranted", function (event) { var _a, _b; var slot = event.slot; console.group("Reward granted for slot", slot.getSlotElementId(), "."); // Log details of the reward. console.log("Reward type:", (_a = event.payload) === null || _a === void 0 ? void 0 : _a.type); console.log( "Reward amount:", (_b = event.payload) === null || _b === void 0 ? void 0 : _b.amount ); console.groupEnd(); if (slot === targetSlot) { // Slot specific logic. } });
TypeScript
// This listener is called whenever a reward is granted for a // rewarded ad. const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]); googletag.pubads().addEventListener("rewardedSlotGranted", (event) => { const slot = event.slot; console.group("Reward granted for slot", slot.getSlotElementId(), "."); // Log details of the reward. console.log("Reward type:", event.payload?.type); console.log("Reward amount:", event.payload?.amount); console.groupEnd(); if (slot === targetSlot) { // Slot specific logic. } });
- Şunlara da bakabilirsiniz:
payload
-
payload: null | RewardedPayload
-
Verilen ödülle ilgili bilgileri içeren bir nesne.
-
googletag.events.RewardedSlotReadyEvent
Uzatmalar
Bu etkinlik, ödüllü reklam gösterilmeye hazır olduğunda tetiklenir. Kullanıcıya reklamı görüntülemeden önce görüntüleme seçeneği sunmak yayıncının sorumluluğundadır.
Mülk Özeti | |
---|---|
serviceName
|
Etkinliği tetikleyen hizmetin adı.
Şu kuruluş biriminden devralındı:
|
slot
|
Etkinliği tetikleyen zaman aralığı.
Şu kuruluş biriminden devralındı:
|
Yöntem Özeti | |
---|---|
makeRewardedVisible
|
Ödüllü reklamı gösterir.
|
- Örnek
-
JavaScript
// This listener is called when a rewarded ad slot becomes ready to be // displayed. const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]); googletag.pubads().addEventListener("rewardedSlotReady", (event) => { const slot = event.slot; console.log("Rewarded ad slot", slot.getSlotElementId(), "is ready to be displayed."); // Replace with custom logic. const userHasConsented = true; if (userHasConsented) { event.makeRewardedVisible(); } if (slot === targetSlot) { // Slot specific logic. } });
JavaScript (eski)
// This listener is called when a rewarded ad slot becomes ready to be // displayed. var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]); googletag.pubads().addEventListener("rewardedSlotReady", function (event) { var slot = event.slot; console.log("Rewarded ad slot", slot.getSlotElementId(), "is ready to be displayed."); // Replace with custom logic. var userHasConsented = true; if (userHasConsented) { event.makeRewardedVisible(); } if (slot === targetSlot) { // Slot specific logic. } });
TypeScript
// This listener is called when a rewarded ad slot becomes ready to be // displayed. const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]); googletag.pubads().addEventListener("rewardedSlotReady", (event) => { const slot = event.slot; console.log("Rewarded ad slot", slot.getSlotElementId(), "is ready to be displayed."); // Replace with custom logic. const userHasConsented = true; if (userHasConsented) { event.makeRewardedVisible(); } if (slot === targetSlot) { // Slot specific logic. } });
- Şunlara da bakabilirsiniz:
makeRewardedVisible
-
makeRewardedVisible(): void
-
Ödüllü reklamı gösterir. Kullanıcı reklamı görüntülemeyi kabul edene kadar bu yöntem çağrılmamalıdır.
-
googletag.events.SlotOnloadEvent
Uzatmalar
Bu etkinlik, reklam öğesinin iframe'i yükleme etkinliğini tetiklediğinde tetiklenir. Rich media reklamları eşzamanlı oluşturma modunda oluşturulurken iframe kullanılmaz, dolayısıyla hiçbir SlotOnloadEvent
tetiklenmez.
Mülk Özeti | |
---|---|
serviceName
|
Etkinliği tetikleyen hizmetin adı.
Şu kuruluş biriminden devralındı:
|
slot
|
Etkinliği tetikleyen zaman aralığı.
Şu kuruluş biriminden devralındı:
|
- Örnek
-
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 (eski)
// 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. } });
- Şunlara da bakabilirsiniz:
googletag.events.SlotRenderEndedEvent
Uzatmalar
Bu etkinlik, reklam öğesi kodu bir alana yerleştirildiğinde tetiklenir. Bu etkinlik, reklam öğesi kaynakları getirilmeden önce gerçekleşeceğinden reklam öğesi henüz görünmeyebilir. Bir alan için tüm reklam öğesi kaynaklarının yüklenmesinin ne zaman tamamlandığını öğrenmek istiyorsanız bunun yerine events.SlotOnloadEvent
özelliğini kullanabilirsiniz.
Mülk Özeti | |
---|---|
advertiserId
|
Oluşturulan reklamın reklamveren kimliği.
|
campaignId
|
Oluşturulan reklamın kampanya kimliği.
|
companyIds
|
Oluşturulan dolgu reklama teklif veren şirketlerin kimlikleri.
|
creativeId
|
Oluşturulan rezervasyon reklamının reklam öğesi kimliği.
|
creativeTemplateId
|
Oluşturulan rezervasyon reklamının reklam öğesi şablon kimliği.
|
isBackfill
|
Bir reklamın dolgu reklam olup olmadığı.
|
isEmpty
|
Alan için bir reklamın döndürülüp döndürülmediği.
|
labelIds
|
Oluşturulan reklamın etiket kimlikleri.
|
lineItemId
|
Oluşturulan rezervasyon reklamının satır öğesi kimliği.
|
serviceName
|
Etkinliği tetikleyen hizmetin adı.
Şu kuruluş biriminden devralındı:
|
size
|
Oluşturulan reklam öğesinin piksel boyutunu gösterir.
|
slot
|
Etkinliği tetikleyen zaman aralığı.
Şu kuruluş biriminden devralındı:
|
slotContentChanged
|
Alan içeriğinin oluşturulan reklamla değiştirilip değiştirilmediği.
|
sourceAgnosticCreativeId
|
Oluşturulan rezervasyon veya dolgu reklamın reklam öğesi kimliği.
|
sourceAgnosticLineItemId
|
Oluşturulan rezervasyon veya dolgu reklamın satır öğesi kimliği.
|
yieldGroupIds
|
Oluşturulan dolgu reklam için getiri gruplarının kimlikleri.
|
- Örnek
-
JavaScript
// This listener is called when a slot has finished rendering. const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]); googletag.pubads().addEventListener("slotRenderEnded", (event) => { const slot = event.slot; console.group("Slot", slot.getSlotElementId(), "finished rendering."); // Log details of the rendered ad. console.log("Advertiser ID:", event.advertiserId); console.log("Campaign ID:", event.campaignId); console.log("Company IDs:", event.companyIds); console.log("Creative ID:", event.creativeId); console.log("Creative Template ID:", event.creativeTemplateId); console.log("Is backfill?:", event.isBackfill); console.log("Is empty?:", event.isEmpty); console.log("Label IDs:", event.labelIds); console.log("Line Item ID:", event.lineItemId); console.log("Size:", event.size); console.log("Slot content changed?", event.slotContentChanged); console.log("Source Agnostic Creative ID:", event.sourceAgnosticCreativeId); console.log("Source Agnostic Line Item ID:", event.sourceAgnosticLineItemId); console.log("Yield Group IDs:", event.yieldGroupIds); console.groupEnd(); if (slot === targetSlot) { // Slot specific logic. } });
JavaScript (eski)
// This listener is called when a slot has finished rendering. var targetSlot = googletag.defineSlot("/1234567/example", [160, 600]); googletag.pubads().addEventListener("slotRenderEnded", function (event) { var slot = event.slot; console.group("Slot", slot.getSlotElementId(), "finished rendering."); // Log details of the rendered ad. console.log("Advertiser ID:", event.advertiserId); console.log("Campaign ID:", event.campaignId); console.log("Company IDs:", event.companyIds); console.log("Creative ID:", event.creativeId); console.log("Creative Template ID:", event.creativeTemplateId); console.log("Is backfill?:", event.isBackfill); console.log("Is empty?:", event.isEmpty); console.log("Label IDs:", event.labelIds); console.log("Line Item ID:", event.lineItemId); console.log("Size:", event.size); console.log("Slot content changed?", event.slotContentChanged); console.log("Source Agnostic Creative ID:", event.sourceAgnosticCreativeId); console.log("Source Agnostic Line Item ID:", event.sourceAgnosticLineItemId); console.log("Yield Group IDs:", event.yieldGroupIds); console.groupEnd(); if (slot === targetSlot) { // Slot specific logic. } });
TypeScript
// This listener is called when a slot has finished rendering. const targetSlot = googletag.defineSlot("/1234567/example", [160, 600]); googletag.pubads().addEventListener("slotRenderEnded", (event) => { const slot = event.slot; console.group("Slot", slot.getSlotElementId(), "finished rendering."); // Log details of the rendered ad. console.log("Advertiser ID:", event.advertiserId); console.log("Campaign ID:", event.campaignId); console.log("Company IDs:", event.companyIds); console.log("Creative ID:", event.creativeId); console.log("Creative Template ID:", event.creativeTemplateId); console.log("Is backfill?:", event.isBackfill); console.log("Is empty?:", event.isEmpty); console.log("Label IDs:", event.labelIds); console.log("Line Item ID:", event.lineItemId); console.log("Size:", event.size); console.log("Slot content changed?", event.slotContentChanged); console.log("Source Agnostic Creative ID:", event.sourceAgnosticCreativeId); console.log("Source Agnostic Line Item ID:", event.sourceAgnosticLineItemId); console.log("Yield Group IDs:", event.yieldGroupIds); console.groupEnd(); if (slot === targetSlot) { // Slot specific logic. } });
- Şunlara da bakabilirsiniz:
advertiserId
-
advertiserId: null | number
-
Oluşturulan reklamın reklamveren kimliği. Boş alanlar, dolgu reklamlar ve
PubAdsService
dışındaki hizmetler tarafından oluşturulan reklam öğeleri için değernull
. -
campaignId
-
campaignId: null | number
-
Oluşturulan reklamın kampanya kimliği. Boş alanlar, dolgu reklamlar ve
PubAdsService
dışındaki hizmetler tarafından oluşturulan reklam öğeleri için değernull
. -
companyIds
-
companyIds: null | number[]
-
Oluşturulan dolgu reklama teklif veren şirketlerin kimlikleri. Boş alanlar, rezervasyon reklamları ve
PubAdsService
dışındaki hizmetler tarafından oluşturulan reklam öğeleri için değernull
. -
creativeId
-
creativeId: null | number
-
Oluşturulan rezervasyon reklamının reklam öğesi kimliği. Boş alanlar, dolgu reklamlar ve
PubAdsService
dışındaki hizmetler tarafından oluşturulan reklam öğeleri için değernull
. -
creativeTemplateId
-
creativeTemplateId: null | number
-
Oluşturulan rezervasyon reklamının reklam öğesi şablon kimliği. Boş alanlar, dolgu reklamlar ve
PubAdsService
dışındaki hizmetler tarafından oluşturulan reklam öğeleri için değernull
. -
isBackfill
-
isBackfill: boolean
-
Bir reklamın dolgu reklam olup olmadığı. Reklam dolgu reklamsa değer
true
, değilsefalse
olur. -
isEmpty
-
isEmpty: boolean
-
Alan için bir reklamın döndürülüp döndürülmediği. Değer, hiç reklam döndürülmediyse
true
, döndürülmediysefalse
olur. -
labelIds
-
labelIds: null | number[]
-
Oluşturulan reklamın etiket kimlikleri. Boş alanlar, dolgu reklamlar ve
PubAdsService
dışındaki hizmetler tarafından oluşturulan reklam öğeleri için değernull
. -
lineItemId
-
lineItemId: null | number
-
Oluşturulan rezervasyon reklamının satır öğesi kimliği. Boş alanlar, dolgu reklamlar ve
PubAdsService
dışındaki hizmetler tarafından oluşturulan reklam öğeleri için değernull
. -
size
-
size: null | string | number[]
-
Oluşturulan reklam öğesinin piksel boyutunu gösterir. Örnek:
[728, 90]
. Boş reklam alanları için değer:null
. -
slotContentChanged
-
slotContentChanged: boolean
-
Alan içeriğinin oluşturulan reklamla değiştirilip değiştirilmediği. İçerik değiştiyse değer
true
, değilsefalse
olur. -
sourceAgnosticCreativeId
-
sourceAgnosticCreativeId: null | number
-
Oluşturulan rezervasyon veya dolgu reklamın reklam öğesi kimliği. Reklam bir rezervasyon veya satır öğesi dolgusu değilse ya da reklam öğesi
PubAdsService
dışındaki hizmetler tarafından oluşturulmuşsa değernull
olur. -
sourceAgnosticLineItemId
-
sourceAgnosticLineItemId: null | number
-
Oluşturulan rezervasyon veya dolgu reklamın satır öğesi kimliği. Reklam bir rezervasyon veya satır öğesi dolgusu değilse ya da reklam öğesi
PubAdsService
dışındaki hizmetler tarafından oluşturulmuşsa değernull
olur. -
yieldGroupIds
-
yieldGroupIds: null | number[]
-
Oluşturulan dolgu reklam için getiri gruplarının kimlikleri. Boş alanlar, rezervasyon reklamları ve
PubAdsService
dışındaki hizmetler tarafından oluşturulan reklam öğeleri için değernull
. -
googletag.events.SlotRequestedEvent
Uzatmalar
Bu etkinlik, belirli bir alan için reklam istendiğinde tetiklenir.
Mülk Özeti | |
---|---|
serviceName
|
Etkinliği tetikleyen hizmetin adı.
Şu kuruluş biriminden devralındı:
|
slot
|
Etkinliği tetikleyen zaman aralığı.
Şu kuruluş biriminden devralındı:
|
- Örnek
-
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 (eski)
// 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. } });
- Şunlara da bakabilirsiniz:
googletag.events.SlotResponseReceived
Uzatmalar
Belirli bir alan için reklam yanıtı alındığında bu etkinlik tetiklenir.
Mülk Özeti | |
---|---|
serviceName
|
Etkinliği tetikleyen hizmetin adı.
Şu kuruluş biriminden devralındı:
|
slot
|
Etkinliği tetikleyen zaman aralığı.
Şu kuruluş biriminden devralındı:
|
- Örnek
-
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 (eski)
// 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. } });
- Şunlara da bakabilirsiniz:
googletag.events.SlotVisibilityChangedEvent
Uzatmalar
Bu etkinlik, bir reklam alanının ekrandaki yüzdesi değiştiğinde tetiklenir. Etkinlik sınırlandırılır ve 200 ms'de bir defadan daha sık tetiklenmez.
Mülk Özeti | |
---|---|
inViewPercentage
|
Reklam alanının görünür durumdaki yüzdesi.
|
serviceName
|
Etkinliği tetikleyen hizmetin adı.
Şu kuruluş biriminden devralındı:
|
slot
|
Etkinliği tetikleyen zaman aralığı.
Şu kuruluş biriminden devralındı:
|
- Örnek
-
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 (eski)
// 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. } });
- Şunlara da bakabilirsiniz:
inViewPercentage
-
inViewPercentage: number
-
Reklam alanının görünür durumdaki yüzdesi. Değer, 0 ile 100 arasında bir sayıdır.
-
googletag.secureSignals.BidderSignalProvider
Belirli bir teklif veren için güvenli sinyal döndürür.
Teklif veren güvenli sinyal sağlayıcısı 2 bölümden oluşur:
- Güvenli sinyale çözümlenen bir
Promise
döndüren toplayıcı işlevi. - Sinyalle ilişkili teklif vereni tanımlayan bir
id
.
secureSignals.PublisherSignalProvider
değerini kullanın.
Mülk Özeti | |
---|---|
collectorFunction
|
.
|
id
|
Bu güvenli sinyalle ilişkili toplayıcı için, Google Ad Manager'da kayıtlı benzersiz bir tanımlayıcı.
|
- Örnek
-
JavaScript
// id is provided googletag.secureSignalProviders.push({ id: "collector123", collectorFunction: () => { // ...custom signal generation logic... return Promise.resolve("signal"); }, });
JavaScript (eski)
// 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"); }, });
- Şunlara da bakabilirsiniz:
collectorFunction
-
collectorFunction: () => Promise<string>
-
id
-
id: string
-
Bu güvenli sinyalle ilişkili toplayıcı için, Google Ad Manager'da kayıtlı benzersiz bir tanımlayıcı.
-
googletag.secureSignals.PublisherSignalProvider
Belirli bir yayıncı için güvenli sinyal döndürür.
Yayıncı sinyali sağlayıcısı 2 bölümden oluşur:
- Güvenli sinyale çözümlenen bir
Promise
döndüren toplayıcı işlevi. - Sinyalle ilişkili yayıncıyı tanımlayan bir
networkCode
.
secureSignals.BidderSignalProvider
değerini kullanın.
Mülk Özeti | |
---|---|
collectorFunction
|
.
|
networkCode
|
Bu güvenli sinyalle ilişkili yayıncının ağ kodu (reklam birimi yolunda görüldüğü gibi).
|
- Örnek
-
JavaScript
// networkCode is provided googletag.secureSignalProviders.push({ networkCode: "123456", collectorFunction: () => { // ...custom signal generation logic... return Promise.resolve("signal"); }, });
JavaScript (eski)
// 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"); }, });
- Şunlara da bakabilirsiniz:
collectorFunction
-
collectorFunction: () => Promise<string>
-
networkCode
-
networkCode: string
-
Bu güvenli sinyalle ilişkili yayıncının ağ kodu (reklam birimi yolunda görüldüğü gibi).
-
googletag.secureSignals.SecureSignalProvidersArray
Güvenli sinyalleri yönetmek için kullanılan bir arayüz.
Yöntem Özeti | |
---|---|
clearAllCache
|
Önbelleğe alınan tüm sinyalleri yerel depolama alanından temizler.
|
push
|
Sinyal sağlayıcı dizisine yeni bir
secureSignals.SecureSignalProvider ekler ve sinyal oluşturma işlemini başlatır.
|
clearAllCache
-
clearAllCache(): void
-
Önbelleğe alınan tüm sinyalleri yerel depolama alanından temizler.
-
push
-
push(provider: SecureSignalProvider): void
-
Sinyal sağlayıcı dizisine yeni bir
secureSignals.SecureSignalProvider
ekler ve sinyal oluşturma işlemini başlatır. -
-
Parametreler provider: SecureSignalProvider
Diziye ekleneceksecureSignals.SecureSignalProvider
nesnesi.