Bir reklam grubu tanımlamak ve eklemek için kullanılan yöntemleri içerir. Oluşturucular hakkında bilgi için bkz. Oluşturucular.
Örnek kullanım:
// Get a campaign to add the ad group to.
var iterator = AdsApp.campaigns()
.withIds(['CAMPAIGN ID GOES HERE'])
.get();
while (iterator.hasNext()) {
var campaign = iterator.next();
// Get the campaign's ad group builder and add an ad group.
var operation = campaign.newAdGroupBuilder()
.withName("AD GROUP NAME GOES HERE")
.withStatus("ENABLED")
.build();
// See the Builders topic for performance considerations
// when using the operation object's methods.
if (!operation.isSuccessful()) {
for (var error of operation.getErrors()) {
Logger.log(`${error}\n`);
}
}
}
Teklif stratejisinin uygulandığı reklam grubu oluşturucusu.
withCpc(çift cpc)
Reklam grubunun CPC teklifini ayarlar.
Anahtar sözcük kullanıcının arama terimiyle eşleştiğinde ve reklam grubunun teklif stratejisi MANUAL_CPC olduğunda kullanılacak teklif tutarını belirtir. Bu teklif, anahtar sözcük gibi alt düzey bir varlık geçersiz kılmazsa kullanılır.
Bağımsız değişken
Name
Tür
Açıklama
Tbm
Çift
Reklam grubunun en yüksek TBM teklifi. Hesabın para birimi, minimum ve maksimum teklif değerlerini belirler. Daha fazla bilgi için bkz. Teklif ve bütçe para birimleri.
CPC teklifinin uygulandığı reklam grubu oluşturucusu.
withCpm(çift cpm)
Reklam grubunun CPM teklifini ayarlar.
Görüntülenen 1.000 gösterim başına kullanılacak teklif tutarını ve reklam grubunun teklif stratejisinin MANUAL_CPM belirtir.
Bağımsız değişken
Name
Tür
Açıklama
Bgbm
Çift
Reklam grubunun maksimum CPM teklifi. Hesabın para birimi, minimum ve maksimum teklif değerlerini belirler. Daha fazla bilgi için bkz. Teklif ve bütçe para birimleri.
CPM teklifinin uygulandığı reklam grubu oluşturucusu.
withCpv(çift cpv)
Reklam grubunun CPV teklifini ayarlar.
Görüntü başına veya video reklamını tıklama başına ve reklam grubunun teklif stratejisinin MANUAL_CPV için kullanılacak teklif tutarını belirtir.
Bağımsız değişken
Name
Tür
Açıklama
Gbm
Çift
Reklam grubunun en yüksek GBM teklifi. Hesabın para birimi, minimum ve maksimum teklif değerlerini belirler. Daha fazla bilgi için bkz. Teklif ve bütçe para birimleri.
CPV teklifinin uygulandığı reklam grubu oluşturucusu.
withCustomParameters(Object customParameters)
Reklam grubunun özel parametrelerini son URL'lerde veya izleme şablonlarında kullanılacak şekilde ayarlar.
Özel parametreler, dinamik bilgilerin birden çok URL arasında paylaşılmasında yararlıdır. Kullanımı hakkında daha fazla bilgi için bkz. Özel Parametreler.
Bağımsız değişken
Name
Tür
Açıklama
customParameters
Nesne
Reklam grubuna uygulanacak en fazla üç özel parametrenin haritası. Örneğin, {key1: 'value1', key2: 'value2', key3: 'value3'}burada anahtar özel parametrenin adı, değer ise parametrenin değeridir. Ad en fazla 16 8 bayt karakter ve değer en fazla 200 8 bayt karakter içerebilir.
Özel parametrelerin uygulandığı Reklam grubu oluşturucusu.
withEndDate(dize endDate)
Reklam grubundaki reklamların yayınlanmayı durdurduğu tarihi ayarlar. Bu yöntemi yalnızca gruptaki reklamların belirli bir tarihte sunulmasını durdurmasını istiyorsanız çağırın.
Bağımsız değişken
Name
Tür
Açıklama
Bitiştarihi
Dize
Reklam yayınlamayı durdurma tarihi. YYYYMMDD biçimindeki tarihi belirtin.
Bitiş tarihi uygulanmış reklam grubu oluşturucusu.
withEndDate(Nesne bitişTarihi)
Reklam grubundaki reklamların yayınlanmayı durdurduğu tarihi ayarlar. Bu yöntemi yalnızca gruptaki reklamların belirli bir tarihte sunulmasını durdurmasını istiyorsanız çağırın.
Bağımsız değişken
Name
Tür
Açıklama
Bitiştarihi
Nesne
Reklam yayınlamayı durdurma tarihi. Aşağıdaki alanlara sahip bir nesne kullanarak tarihi belirtin:
Yıl
Ay
Gün
Örneğin: var date = {year: 2018, month: 5, day: 13};
Ay, 1'in Ocak ve 12'nin Aralık olduğu tek tabanlıdır.
Bitiş tarihi uygulanmış reklam grubu oluşturucusu.
withLanguage(dize dili)
Bu reklam grubundaki reklamlar tarafından kullanılan dili ayarlar.
Varsayılan olarak, reklam grubu dili ana kampanyasından devralır. Kampanya düzeyinde belirtilen dili geçersiz kılmak için reklam grubu düzeyinde bir dil belirtin veya kampanya bir dil belirtmiyorsa (dil, kampanya ve/veya reklam grubu düzeyinde belirtilmelidir).
Bağımsız değişken
Name
Tür
Açıklama
Dil
Dize
Reklam grubundaki reklamlar tarafından kullanılan dil. Örneğin, İngilizce. Dize büyük/küçük harfe duyarlı değildir. İki karakterli bir dil kodu kullanmayın. Desteklenen dillerin listesi için bkz. Reklam Dilleri.
Reklam grubundaki reklamların yayınlanmaya başlayacağı tarihi ayarlar. Bu yöntemi yalnızca gruptaki reklamların belirli bir tarihte yayınlanmaya başlamasını istiyorsanız çağırın; aksi takdirde reklamlar hemen yayınlanmaya başlar.
Bağımsız değişken
Name
Tür
Açıklama
Bitiştarihi
Dize
Reklam yayınlamaya başlama tarihi. YYYYMMDD biçimindeki tarihi belirtin.
Başlangıç tarihi uygulanmış reklam grubu oluşturucusu.
withStartDate(Nesne başlangıçTarihi)
Reklam grubundaki reklamların yayınlanmaya başlayacağı tarihi ayarlar. Bu yöntemi yalnızca gruptaki reklamların belirli bir tarihte yayınlanmaya başlamasını istiyorsanız çağırın; aksi takdirde reklamlar hemen yayınlanmaya başlar.
Bağımsız değişken
Name
Tür
Açıklama
Bitiştarihi
Nesne
Reklam yayınlamaya başlama tarihi. Aşağıdaki alanlara sahip bir nesne kullanarak tarihi belirtin:
Yıl
Ay
Gün
Örneğin: var date = {year: 2018, month: 5, day: 13};
Ay, 1'in Ocak ve 12'nin Aralık olduğu tek tabanlıdır.