AdGroupBuilder

Bir reklam grubu tanımlamak ve eklemek için kullanılan yöntemleri içerir. İnşaatçılar hakkında daha fazla bilgi için bkz: İnşaatçılar.

Ö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ı İade Türü Açıklama
İnşa etmek AdGroupOperation Reklam grubunu oluşturur ve reklam grubunun başarıyla eklenip eklenmediğini kontrol etmek için kullanılan bir işlem nesnesi döndürür.
withBiddingStrategy(string biddingStrategy) AdGroupBuilder Reklam grubunun teklif stratejisini belirler.
ileCpc(çift cpc) AdGroupBuilder Reklam grubunun maksimum TBM teklifini belirler.
withCpm(double cpm) AdGroupBuilder Reklam grubunun maksimum BGBM teklifini belirler.
withCpv(çift cpv) AdGroupBuilder Reklam grubunun maksimum GBM teklifini belirler.
withCustomParameters(Object customParameters) AdGroupBuilder Reklam grubunun özel parametrelerini ayarlar.
withEndDate(dize endDate) AdGroupBuilder Reklam grubundaki reklamların yayınının durdurulacağı tarihi ayarlar.
withEndDate(Object endDate) AdGroupBuilder Reklam grubundaki reklamların yayınının durdurulacağı 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(dize başlangıçTarihi) AdGroupBuilder Reklam grubundaki reklamların yayınlanmaya başlayacağı tarihi belirler.
withStartDate(Object startDate) AdGroupBuilder Reklam grubundaki reklamların yayınlanmaya başlayacağı tarihi belirler.
withStatus(dize durumu) AdGroupBuilder Reklam grubunun durumunu ayarlar.
withTrackingTemplate(dize izlemeŞablonu) AdGroupBuilder Reklam grubunun izleme şablonunu ayarlar.

İnşa etmek

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

Geri dönüşler

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

withBiddingStrategy(string biddingStrategy)

Reklam grubunun teklif stratejisini belirler.

Bağımsız değişkenler

Name Tür Açıklama
biddingStrategy dize Reklam grubuna uygulanacak teklif stratejisi. Büyük/küçük harfe duyarlı olası değerler aşağıdadır.
  • MANUAL_CPC
  • MANUAL_CPM
  • MANUAL_CPV
Bu stratejiler hakkında bilgi için Teklif Stratejisi Türleri başlıklı makaleye göz atın.

Geri dönüşler

Tür Açıklama
AdGroupBuilder Teklif stratejisinin uygulandığı reklam grubu oluşturucu.

ileCpc(çift cpc)

Reklam grubunun TBM teklifini belirler.

Anahtar kelime 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 kelime gibi daha düşük düzeyli bir varlık onu geçersiz kılmazsa kullanılır.

Bağımsız değişkenler

Name Tür Açıklama
TBM çift kişilik Reklam grubunun maksimum TBM teklifi. Hesabın para birimi, minimum ve maksimum teklif değerlerini belirler. Daha fazla bilgi için Teklif ve bütçe para birimleri bölümüne bakın.

Geri dönüşler

Tür Açıklama
AdGroupBuilder TBM teklifinin uygulandığı reklam grubu oluşturucu.

withCpm(double cpm)

Reklam grubunun BGBM teklifini belirler.

Görüntülenen 1.000 gösterim başına kullanılacak teklif tutarını ve reklam grubunun teklif stratejisinin ne zaman MANUAL_CPM olduğunu belirtir.

Bağımsız değişkenler

Name Tür Açıklama
BGBM çift kişilik Reklam grubunun maksimum BGBM teklifi. Hesabın para birimi, minimum ve maksimum teklif değerlerini belirler. Daha fazla bilgi için Teklif ve bütçe para birimleri bölümüne bakın.

Geri dönüşler

Tür Açıklama
AdGroupBuilder BGBM teklifinin uygulandığı reklam grubu oluşturucu.

withCpv(çift cpv)

Reklam grubunun GBM teklifini belirler.

Bir video reklamda görüntüleme veya tıklama başına kullanılacak teklif tutarını ve reklam grubunun teklif stratejisinin ne zaman MANUAL_CPV olduğunu belirtir.

Bağımsız değişkenler

Name Tür Açıklama
GBM çift kişilik Reklam grubunun maksimum GBM teklifi. Hesabın para birimi, minimum ve maksimum teklif değerlerini belirler. Daha fazla bilgi için Teklif ve bütçe para birimleri bölümüne bakın.

Geri dönüşler

Tür Açıklama
AdGroupBuilder GBM teklifinin uygulandığı reklam grubu oluşturucu.

withCustomParameters(Object customParameters)

Reklam grubunun nihai URL'lerde veya izleme şablonlarında kullanılacak özel parametrelerini ayarlar.

Özel parametreler, birden çok URL'de dinamik bilgilerin paylaşılması konusunda yardımcı olur. Kullanımı hakkında daha fazla bilgi için Özel Parametreler'e bakın.

Bağımsız değişkenler

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ı ve değer de parametrenin değeridir. Ad en fazla 16 adet 8 baytlık karakter içerebilir ve değer en çok 200 adet 8 baytlık karakter içerebilir.

Geri dönüşler

Tür Açıklama
AdGroupBuilder Özel parametrelerin uygulandığı reklam grubu oluşturucu.

withEndDate(dize endDate)

Reklam grubundaki reklamların yayınının durdurulacağı tarihi ayarlar. Bu yöntemi yalnızca gruptaki reklamların belirli bir tarihte yayınının durdurulmasını istiyorsanız kullanın.

Bağımsız değişkenler

Name Tür Açıklama
bitiş tarihi dize Reklam yayınının durdurulacağı tarih. YYYYAAGG biçiminde tarihi belirtin.

Geri dönüşler

Tür Açıklama
AdGroupBuilder Bitiş tarihi uygulanmış reklam grubu oluşturucu.

withEndDate(Object endDate)

Reklam grubundaki reklamların yayınının durdurulacağı tarihi ayarlar. Bu yöntemi yalnızca gruptaki reklamların belirli bir tarihte yayınının durdurulmasını istiyorsanız kullanın.

Bağımsız değişkenler

Name Tür Açıklama
bitiş tarihi Nesne Reklam yayınının durdurulacağı tarih. 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.

Geri dönüşler

Tür Açıklama
AdGroupBuilder Bitiş tarihi uygulanmış reklam grubu oluşturucu.

withLanguage(dize dili)

Bu reklam grubundaki reklamlar tarafından kullanılan dili ayarlar.

Varsayılan olarak, reklam grubu dili üst kampanyasından devralır. Kampanya düzeyinde belirtilen dili geçersiz kılmak için veya kampanya bir dil belirtmiyorsa reklam grubu düzeyinde bir dil belirtin (dil, kampanya ve/veya reklam grubu düzeyinde belirtilmelidir).

Bağımsız değişkenler

Name Tür Açıklama
Dilim 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 Reklam Dilleri bölümüne bakın.

Geri dönüşler

Tür Açıklama
AdGroupBuilder Uygulanan dille reklam grubu oluşturucu.

withName(dize adı)

Reklam grubunun adını ayarlar.

Bağımsız değişkenler

Name Tür Açıklama
İsim-Soyisim dize Reklam grubunun adı. Ad zorunludur. Ad en fazla 256 karakter içerebilir ve kampanyadaki tüm etkin reklam grupları arasında benzersiz olmalıdır.

Geri dönüşler

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

withStartDate(dize başlangıçTarihi)

Reklam grubundaki reklamların yayınlanmaya başlayacağı tarihi belirler. Bu yöntemi yalnızca gruptaki reklamların belirli bir tarihte yayınlanmaya başlamasını istiyorsanız kullanın. Aksi takdirde, reklamlar hemen yayınlanmaya başlar.

Bağımsız değişkenler

Name Tür Açıklama
bitiş tarihi dize Reklam yayınlamaya başlama tarihi. YYYYAAGG biçiminde tarihi belirtin.

Geri dönüşler

Tür Açıklama
AdGroupBuilder Başlangıç tarihinin uygulandığı reklam grubu oluşturucu.

withStartDate(Object startDate)

Reklam grubundaki reklamların yayınlanmaya başlayacağı tarihi belirler. Bu yöntemi yalnızca gruptaki reklamların belirli bir tarihte yayınlanmaya başlamasını istiyorsanız kullanın. Aksi takdirde, reklamlar hemen yayınlanmaya başlar.

Bağımsız değişkenler

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.

Geri dönüşler

Tür Açıklama
AdGroupBuilder Başlangıç tarihinin uygulandığı reklam grubu oluşturucu.

withStatus(dize durumu)

Reklam grubunun durumunu ayarlar.

Bağımsız değişkenler

Name Tür Açıklama
Durum Dize Reklam grubunun durumu. Büyük/küçük harfe duyarlı olası değerler aşağıdadır.
  • ETKİNLEŞTİRİLDİ
  • DURAKLATILDI
  • KALDIRILDI
Varsayılan değer DURAKLATILDI'dır.

Geri dönüşler

Tür Açıklama
AdGroupBuilder Durum bilgisi uygulanmış reklam grubu oluşturucu.

withTrackingTemplate(dize izlemeŞablonu)

Reklam grubunun izleme şablonunu ayarlar.

İzleme şablonları, reklam tarafından kullanılan hedef URL'yi oluşturmak için anahtar kelimenin FinalUrl'si ile birlikte kullanılır. Daha fazla bilgi için Hangi izleme veya URL parametrelerini kullanabilirim? bölümüne bakın.

Bağımsız değişkenler

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

Geri dönüşler

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

Ayrıca bkz.

Campaign.newAdGroupBuilder()

  • Last updated on