GPT Referansı

Bağımsız değişkenlerde belirtilen işlev dizisini 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());
});

Doldurulmamış tamamlayıcı alanların otomatik olarak doldurulup doldurulmayacağını belirler.

Bu yöntem, doldurma işlemini etkinleştirmek ve devre dışı bırakmak için sayfanın ömrü boyunca birden çok kez çağrılabilir. Yalnızca PubAdsService'e de kayıtlı olan alanlar doldurulur. Politika kısıtlamaları nedeniyle bu yöntem, bir Ad Exchange videosu yayınlandığında boş tamamlayıcı slotları doldurmak için tasarlanmamıştır.

Örnek

JavaScript

googletag.companionAds().setRefreshUnfilledSlots(true);

JavaScript (eski)

googletag.companionAds().setRefreshUnfilledSlots(true);

TypeScript

googletag.companionAds().setRefreshUnfilledSlots(true);

Sayfanın çocuklara yönelik olarak değerlendirilip değerlendirilmeyeceğini belirtir. Yapılandırmayı temizlemek için null olarak ayarlayın.

Yayıncının yasal uygunluk ihtiyaçlarını desteklemek için yayınların sınırlı reklamlar modunda yayınlanmasını sağlar.

GPT'ye sınırlı reklam isteğinde bulunmasını iki şekilde bildirebilirsiniz:

• IAB TCF 2.0 kullanıcı rızası yönetim platformundan gelen bir sinyal kullanılarak otomatik olarak.
• Bu alanın değerini true olarak ayarlayarak manuel olarak.

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

Aşağıdaki kaynakları da incelemenizi öneririz:

• Sınırlı reklam görüntüleme

Yayıncıların yasal düzenlemelere uygunluk gereksinimlerine yardımcı olmak için yayını kişiselleştirilmemiş reklamlar modunda çalışacak şekilde etkinleştirir.

Yayıncının yasal uygunluk ihtiyaçlarını desteklemek için yayınlamanın kısıtlanmış işleme modunda çalışmasını sağlar.

İsteklerin satın alınan trafiği mi yoksa organik trafiği mi temsil ettiğini belirtir. Bu değer, Ad Manager raporlarında Trafik kaynağı boyutunu doldurur. Ayarlanmamışsa trafik kaynağı, raporlarda 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,
});

Reklam isteklerinin reşit olma yaşının altındaki kullanıcılardan gelen kullanıcılar olarak işaretlenip işaretlenmeyeceğini belirtir. Yapılandırmayı temizlemek için null olarak ayarlayın.

Reklamları belirtilen slotlardan kaldırır ve boş içerikle değiştirir. Alanlar, getirilmedi olarak işaretlenecektir.

Özellikle bir alanın temizlenmesi, reklamı GPT'nin uzun süreli sayfa görüntülemesinden kaldırır. Böylece 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();

Sayfa düzeyindeki tüm reklam kategorisi hariç tutma etiketlerini temizler. Alanı yenilemek istiyorsanız bu yararlı bir özelliktir.

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

Aşağıdaki kaynakları da incelemenizi öneririz:

• Reklamları engellemek için özel etiketler

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.

Aşağıdaki kaynakları da incelemenizi öneririz:

• Anahtar/değer çifti hedefleme

Gösterilecek reklam içeriği olmadığında alan div'lerinin sayfada yer kaplamaması için daraltılmasını etkinleştirir. Bu mod, hizmet etkinleştirilmeden önce ayarlanmalıdır.

Aşağıdaki kaynakları da incelemenizi öneririz:

• Boş reklam alanlarını daraltma
• Düzen değişikliğini en aza indirme

Sayfa yüklenirken reklam isteklerini devre dışı bırakır ancak PubAdsService.refresh çağrısıyla reklam isteğinde bulunulmasına izin verir. Bu ayar, hizmet etkinleştirilmeden önce yapılmalıdır. Eş zamansız mod kullanılmalıdır. Aksi takdirde, refresh kullanılarak reklam isteğinde bulunulamaz.

Aşağıdaki kaynakları da incelemenizi öneririz:

• Reklam yüklemeyi kontrol etme ve yenileme
• SRA gruplandırmasını kontrol etme

Belirtilen reklam birimi yolu ve boyutuyla bir reklam alanı oluşturup gösterir. Bu yöntem tekli istek modunda çalışmaz.

Not: Bu yöntem çağrıldığında, reklam isteği gönderme ve yanıtı oluşturma sırasında tutarlılığı sağlamak için alan ve sayfa durumunun anlık görüntüsü oluşturulur. Bu yöntem çağrıldıktan sonra slot veya sayfa durumunda yapılan değişiklikler (hedefleme, gizlilik ayarları, SafeFrame'i zorlama vb. dahil) yalnızca sonraki display() veya refresh() 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");

Aşağıdaki kaynakları da incelemenizi öneririz:

• Test reklamı gösterme
• Reklam yüklemeyi kontrol etme ve yenileme

GPT'de, yapılandırma nesnesi tarafından tanımlandığı şekilde 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 slotlar getirme marjının dışındaysa ç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,
});

Aşağıdaki kaynakları da incelemenizi öneririz:

• Reklamlarla ilgili en iyi uygulamalar: "Önemli" reklam alanlarına öncelik verme
• Geç yükleme

Aynı anda birden fazla reklam getirmek için tek istek modunu etkinleştirir. Bunun için, hizmeti etkinleştirmeden önce tüm yayıncı reklam alanlarının tanımlanması ve PubAdsService'e eklenmesi gerekir. Tek istek modu, hizmet etkinleştirilmeden önce ayarlanmalıdır.

Aşağıdaki kaynakları da incelemenizi öneririz:

• Reklamlarla ilgili en iyi uygulamalar: Tekli İstek Mimarisi'ni doğru şekilde kullanma
• SRA gruplandırmasını kontrol etme

GPT'ye sayfada video reklamlar bulunacağını bildirir. Bu seçenek, görüntülü ve video reklamlarda rakip hariç tutma kısıtlamaları sağlar. Video içeriği biliniyorsa görüntülü reklamlar için içerik hariç tutma özelliğini kullanabilmek üzere PubAdsService.setVideoContent'i çağırın.

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

Aşağıdaki kaynakları da incelemenizi öneririz:

• AdSense Özellikleri

Bu hizmette ayarlanmış ö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'].

Ayarlanmış belirli bir özel hizmet düzeyi 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).

Ayarlanmış 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'].

Önceki bir PubAdsService.disableInitialLoad çağrısı tarafından reklamlarla ilgili ilk isteklerin başarıyla devre dışı bırakılıp bırakılmadığını döndürür.

Sayfadaki belirli veya tüm alanlar için yeni reklamlar getirir ve gösterir. Yalnızca asenkron oluşturma modunda çalışır.

Tüm tarayıcılarda düzgün davranış için refresh çağrılmasından önce reklam alanı display çağrılmalıdır. display çağrısı atlanırsa yenileme beklenmedik şekilde davranabilir. İstenirse display ürününün reklam getirmesini durdurmak için PubAdsService.disableInitialLoad yöntemi kullanılabilir.

Alan yenilendiğinde, eski reklam GPT'nin uzun ömürlü sayfa görüntülemesinden kaldırılır. Böylece 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 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 });

Aşağıdaki kaynakları da incelemenizi öneririz:

• Reklam yükleme ve yenilemeyi kontrol etme
• Reklam alanlarını yenileme

Yayıncı reklamları hizmeti kapsamındaki tüm reklam alanları için geçerli olan AdSense özellikleri değerlerini ayarlar.

Bu işlevin aynı anahtar için birden fazla kez çağrılması, söz konusu anahtar için daha önce ayarlanmış değerleri geçersiz kılar. display veya refresh ç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");

Aşağıdaki kaynakları da incelemenizi öneririz:

• AdSense Özellikleri

Belirtilen etiket adı için sayfa düzeyinde bir 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");

Aşağıdaki kaynakları da incelemenizi öneririz:

• Reklamları engellemek için özel etiketler

Reklamların yatay olarak ortalamasını etkinleştirir ve devre dışı bırakır. Ortalama varsayılan olarak devre dışıdır. Eski gpt_mobile.js'de merkezleme varsayılan olarak etkindir.

Yalnızca bu yöntem çağrıldıktan sonra istenen reklamlar merkezleneceğinden, bu yöntem display veya refresh çağrılmadan önce çağrılmalıdı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);

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ğıdaki hususları göz önünde bulundurun:

• Bu ayar yalnızca ilgili alanlar için yapılacak sonraki reklam istekleri için geçerli olur.
• Belirtilen alan düzeyi ayarı, sayfa düzeyindeki ayarı her zaman geçersiz kılar.
• true olarak ayarlanırsa (reklam 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.
• Bununla birlikte, false olarak ayarlanır veya ayarlanmadan bırakılırsa 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'lerinden çıkmaya çalışan veya doğrudan bir yayıncı sayfasında oluşturulmalarına güvenen reklam öğelerinin davranışını etkileyebileceğinden 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");

Aşağıdaki kaynakları da incelemenizi öneririz:

• SafeFrame kullanarak reklam öğeleri oluşturma

Satır öğelerini belirli konumlara coğrafi olarak hedefleyebilmeniz için web sitelerinden konum bilgilerini iletir.

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

Bir yapılandırma nesnesi kullanarak tüm gizlilik ayarlarının tek bir API'den 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,
});

Aşağıdaki kaynakları da incelemenizi öneririz:

• Gizlilik ayarlarını yapılandırma
• Sınırlı reklam görüntüleme

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

Aşağıdaki kaynakları da incelemenizi öneririz:

• Yayıncı tarafından sağlanan tanımlayıcılar hakkında

SafeFrame yapılandırması için sayfa düzeyindeki tercihleri belirler. config nesnesinde tanınmayan anahtarlar yoksayılır. Tanınan bir anahtar için geçersiz bir değer iletilirse yapılandırmanın tamamı göz ardı edilir.

Bu sayfa düzeyindeki tercihler, belirtilirse alan düzeyindeki tercihlerle 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");

Aşağıdaki kaynakları da incelemenizi öneririz:

• SafeFrame kullanarak reklam öğeleri oluşturma

Belirli bir anahtar için tüm Publisher Ads hizmeti reklam alanları için geçerli olan özel hedefleme parametreleri ayarlar. Bu işlevin aynı anahtar için birden çok kez çağrılması, eski değerlerin üzerine yazılır. Bu anahtarlar, Google Ad Manager hesabınızda tanımlanmıştı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"]);

Aşağıdaki kaynakları da incelemenizi öneririz:

• Anahtar/değer çifti hedeflemesi

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 ve videoCmsId için Google Ad Manager içerik besleme hizmetine sağlanan değerleri kullanın.

Aşağıdaki kaynakları da incelemenizi öneririz:

• VAST reklam etiketi URL parametreleri

Reklam istekleriyle birlikte gönderilen ilişkilendiriciyi değiştirerek yeni bir sayfa görüntülemeyi etkili bir şekilde başlatır. İlişkilendirici, bir sayfa görüntülemesinden gelen tüm reklam istekleri için aynıdır ve sayfa görüntülemeleri arasında benzersizdir. Yalnızca eşzamansız modda geçerlidir.

Not: Bu durum, GPT'nin uzun süreli sayfa görüntüleme üzerinde herhangi bir etkiye sahip değildir. Bu durum, sayfadaki reklamları 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.

Reklamverenin kimliği.

Kampanyanın kimliği.

Reklam öğesinin kimliği.

Reklamın şablon kimliği.

Satır öğesinin kimliği.

Ödüle dahil edilen öğelerin sayısı.

Ödüle dahil edilen öğenin türü (ör. "coin").

SafeFrame'in, sayfa içeriğini yer paylaşımı yaparak reklam içeriğinin genişlemesine izin verip vermeyeceği.

SafeFrame'in sayfa içeriğini iterek reklam içeriğinin genişlemesine izin verip vermeyeceği.

SafeFrame'in, kullanıcı etkileşimi olmadan üst düzey gezinmeyi önlemek için HTML5 korumalı alan özelliğini kullanıp kullanmayacağı. Geçerli tek değer true'tür (false olarak zorlanamaz). Korumalı alan özelliğinin eklentileri (ör. Flash) devre dışı bıraktığını unutmayın.

SafeFrame'in, Rezervasyon reklam öğeleri için rastgele alt alan adları kullanıp kullanmayacağı. Depolanan değeri temizlemek için null değerini iletin.

Not: Bu özellik varsayılan olarak etkindir.

Aşağıdaki kaynakları da incelemenizi öneririz:

• SafeFrame kullanarak reklam öğeleri oluşturma

Sayfada belirli bir GPT etkinliği gerçekleştiğinde JavaScript işlevi oluşturmanıza ve çağırmanıza olanak tanıyan bir dinleyici kaydeder. Aşağıdaki etkinlikler desteklenir:

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

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

Aşağıdaki kaynakları da incelemenizi öneririz:

• Reklam etkinliği işleyicileri

Bu hizmetle ilişkili alanların listesini alın.