Aracılığıyla paylaş

AdGroupBuilder

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

Yöntemler

Yöntem Adı Dönüş Türü Açıklama
Oluşturmak AdGroupOperation Reklam grubunu oluşturur ve reklam grubunun başarıyla eklenip eklenmediğini denetlemek için kullanılan bir işlem nesnesini döndürür.
withBiddingStrategy(string biddingStrategy) AdGroupBuilder Reklam grubunun teklif stratejisini ayarlar.
withCpc(çift cpc) AdGroupBuilder Reklam grubunun en yüksek TBM teklifini ayarlar.
withCpm(çift cpm) AdGroupBuilder Reklam grubunun maksimum CPM teklifini ayarlar.
withCpv(çift cpv) AdGroupBuilder Reklam grubunun en yüksek CPV teklifini ayarlar.
withCustomParameters(Object customParameters) AdGroupBuilder Reklam grubunun özel parametrelerini ayarlar.
withEndDate(dize endDate) AdGroupBuilder Reklam grubundaki reklamların yayınlanmayı durdurduğu tarihi ayarlar.
withEndDate(Nesne bitişTarihi) AdGroupBuilder Reklam grubundaki reklamların yayınlanmayı durdurduğu tarihi ayarlar.
withLanguage(dize dili) AdGroupBuilder Bu reklam grubu tarafından kullanılan dili ayarlar.
withName(dize adı) AdGroupBuilder Reklam grubunun adını ayarlar.
withStartDate(startDate dizesi) AdGroupBuilder Reklam grubundaki reklamların yayınlanmaya başlayacağı tarihi ayarlar.
withStartDate(Nesne başlangıçTarihi) AdGroupBuilder Reklam grubundaki reklamların yayınlanmaya başlayacağı tarihi ayarlar.
withStatus(dize durumu) AdGroupBuilder Reklam grubunun durumunu ayarlar.
withTrackingTemplate(dize izlemeTemplate) AdGroupBuilder Reklam grubunun izleme şablonunu ayarlar.

Oluşturmak

Reklam grubunu oluşturur ve reklam grubunun başarıyla eklenip eklenmediğini denetlemek için kullanılan bir işlem nesnesini döndürür.

Döndürür

Tür Açıklama
AdGroupOperation Reklam grubunun başarıyla eklenip eklenmediğini denetlemek için kullanılan bir işlem nesnesi.

withBiddingStrategy(string biddingStrategy)

Reklam grubunun teklif stratejisini ayarlar.

Bağımsız değişken

Name Tür Açıklama
biddingStrategy Dize Reklam grubuna uygulanacak teklif stratejisi. Olası büyük/küçük harfe duyarlı değerler aşağıdadır.
  • MANUAL_CPC
  • MANUAL_CPM
  • MANUAL_CPV
Bu stratejiler hakkında bilgi için bkz . Teklif Stratejisi Türleri.

Döndürür

Tür Açıklama
AdGroupBuilder 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.

Döndürür

Tür Açıklama
AdGroupBuilder 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.

Döndürür

Tür Açıklama
AdGroupBuilder 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.

Döndürür

Tür Açıklama
AdGroupBuilder 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.

Döndürür

Tür Açıklama
AdGroupBuilder Ö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.

Döndürür

Tür Açıklama
AdGroupBuilder 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.

Döndürür

Tür Açıklama
AdGroupBuilder 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.

Döndürür

Tür Açıklama
AdGroupBuilder Dilin uygulandığı reklam grubu oluşturucusu.

withName(dize adı)

Reklam grubunun adını ayarlar.

Bağımsız değişken

Name Tür Açıklama
Adı Dize Reklam grubunun adı. Ad gereklidir. Ad en fazla 256 karakter içerebilir ve kampanyadaki tüm etkin reklam grupları arasında benzersiz olmalıdır.

Döndürür

Tür Açıklama
AdGroupBuilder Adı uygulanmış reklam grubu oluşturucusu.

withStartDate(startDate dizesi)

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.

Döndürür

Tür Açıklama
AdGroupBuilder 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.

Döndürür

Tür Açıklama
AdGroupBuilder Başlangıç tarihi uygulanmış reklam grubu oluşturucusu.

withStatus(dize durumu)

Reklam grubunun durumunu ayarlar.

Bağımsız değişken

Name Tür Açıklama
Durum Dize Reklam grubunun durumu. Olası büyük/küçük harfe duyarlı değerler aşağıdadır.
  • ETKİN
  • DURAKLATILDI
  • KALDIRILDI
Varsayılan olarak PAUSED değeridir.

Döndürür

Tür Açıklama
AdGroupBuilder Durumunun uygulandığı reklam grubu oluşturucusu.

withTrackingTemplate(dize izlemeTemplate)

Reklam grubunun izleme şablonunu ayarlar.

İzleme şablonları, reklam tarafından kullanılan hedef URL'yi oluşturmak için anahtar sözcüğün FinalUrl ile birlikte kullanılır. Daha fazla bilgi için bkz . Hangi izleme veya URL parametrelerini kullanabilirim?

Bağımsız değişken

Name Tür Açıklama
trackingTemplate Dize Reklam grubuyla kullanılacak izleme şablonu.

Döndürür

Tür Açıklama
AdGroupBuilder İzleme şablonunun uygulandığı reklam grubu oluşturucusu.

Ayrıca bkz.

Campaign.newAdGroupBuilder()

  • Last updated on