KeywordBuilder

Anahtar sözcük tanımlama ve oluşturma yöntemlerini içerir. Oluşturucular hakkında bilgi için bkz. Oluşturucular.

Not

Arama reklamları için tüm geniş eşleşme değiştirici anahtar sözcükleri artık tümcecik eşleştirmesi yerine geniş eşleşme anahtar sözcükleri olarak görev görür. Anahtar sözcük eşleştirme türleri hakkında daha fazla bilgi edinin.

Örnek kullanım:

    var operation = adGroup.newKeywordBuilder()
        .withText("KEYWORD TEXT GOES HERE")
        .withCpc(0.5)
        .withFinalUrl("http://www.contoso.com")
        .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	KeywordOperation	Anahtar sözcüğü oluşturur ve anahtar sözcüğün başarıyla eklenip eklenmediğini denetlemek için kullanılan bir işlem nesnesi döndürür.
withCpc(çift cpc)	KeywordBuilder	Anahtar sözcüğün en yüksek CPC teklifini ayarlar.
withCustomParameters(Object customParameters)	KeywordBuilder	Anahtar sözcüğün özel parametrelerini ayarlar.
withFinalUrl(string finalUrl)	KeywordBuilder	Anahtar sözcüğün son URL'sini ayarlar.
withMobileFinalUrl(string mobileFinalUrl)	KeywordBuilder	Mobil cihazlar için anahtar sözcüğün son URL'sini ayarlar.
withText(dize metni)	KeywordBuilder	Anahtar sözcüğün metnini ayarlar.
withTrackingTemplate(dize izlemeTemplate)	KeywordBuilder	Anahtar sözcüğün izleme şablonunu ayarlar.

Oluşturmak

Anahtar sözcüğü oluşturur ve anahtar sözcüğün başarıyla eklenip eklenmediğini denetlemek için kullanılan bir işlem nesnesi döndürür.

Döndürür

Tür	Açıklama
KeywordOperation	Anahtar sözcüğün başarıyla eklenip eklenmediğini denetlemek için kullanılan bir işlem nesnesi.

withCpc(çift cpc)

Anahtar sözcüğün en yüksek CPC teklifini ayarlar.

Anahtar sözcük kullanıcının arama terimiyle eşleştiğinde kullanılacak teklif tutarını belirtir. Yalnızca reklam grubunun teklif stratejisi MANUAL_CPC olarak ayarlandıysa geçerlidir.

Reklam grubu düzeyinde belirtilen teklif tutarını kullanmak için bu yöntemi çağırmayın.

Teklif tutarları hakkında daha fazla bilgi için bkz. Teklif ve BidingScheme.

Bağımsız değişken

Name	Tür	Açıklama
Tbm	Çift	Anahtar kelimeye uygulanacak 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
KeywordBuilder	CPC teklifinin uygulandığı anahtar sözcük oluşturucusu.

withCustomParameters(Object customParameters)

Anahtar sözcüğün özel parametrelerini 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	Anahtar sözcüğün son URL'sine uygulanacak en fazla özel parametre 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
KeywordBuilder	Özel parametrelerin uygulandığı anahtar sözcük oluşturucusu.

withFinalUrl(string finalUrl)

Anahtar sözcüğün son URL'sini ayarlar.

Son URL, kullanıcının reklama tıkladığında çekildiği web sayfasını tanımlar. Belirtilmezse, varlık son URL'yi üst varlığından devralır. Örneğin, anahtar sözcük varlığı reklamın son URL'sini devralır. Reklamın son URL'sini geçersiz kılmak için anahtar sözcüğün son URL'sini belirtin.

Daha fazla bilgi için bkz . Hangi izleme veya URL parametrelerini kullanabilirim?

Bağımsız değişken

Name	Tür	Açıklama
finalUrl	Dize	Kullanıcının reklama tıkladığında çekildiği web sayfasını tanımlayan son URL.

Döndürür

Tür	Açıklama
KeywordBuilder	Son URL'nin uygulandığı anahtar sözcük oluşturucusu.

withMobileFinalUrl(string mobileFinalUrl)

Mobil cihazlar için anahtar sözcüğün son URL'sini ayarlar.

Son URL, kullanıcının reklama tıkladığında çekildiği web sayfasını tanımlar. Belirtilmezse, varlık son URL'yi üst varlığından devralır. Örneğin, anahtar sözcük varlığı reklamın son URL'sini devralır. Reklamın son URL'sini geçersiz kılmak istiyorsanız anahtar sözcüğün son URL'sini belirtin.

Daha fazla bilgi için bkz . Hangi izleme veya URL parametrelerini kullanabilirim?

Mobil cihazlar için son URL'yi belirtmek için önce mobil olmayan cihazlar için son URL'yi belirtin (bkz withFinalUrl(). ).

Bağımsız değişken

Name	Tür	Açıklama
mobileFinalUrl	Dize	Mobil cihazlar için son URL.

Döndürür

Tür	Açıklama
KeywordBuilder	Mobil son URL'nin uygulandığı anahtar sözcük oluşturucusu.

withText(dize metni)

Anahtar sözcüğün metnini ayarlar.

Anahtar sözcüğün eşleşme türünü belirtmek için aşağıdaki söz dizimini kullanın:

• Geniş eşleşme için eşleşme türü söz dizimi kullanmayın (örneğin, keywordBuilder.withText("books")).
• Geniş eşleşme değiştiricisi için, metni artı işaretiyle (+) ekleyin (örneğin, keywordBuilder.withText("+books")). Not: Yeni geniş eşleme değiştirici (BMM) anahtar sözcükleri oluşturmaya çalışırsanız, bunlar kaydedilir ve tümcecik eşleştirme anahtar sözcükleri olarak sunulur. Mevcut BMM anahtar sözcükleriniz tümcecik eşleştirme davranışı altında çalışmaya devam edecektir. Anahtar sözcük eşleştirme türleri hakkında daha fazla bilgi edinin.
• Tümcecik eşleşmesi için metnin etrafına tırnak işareti koyun (örneğin, keywordBuilder.withText("\"books\"")).
• Tam eşleşme için, metnin etrafına köşeli ayraçlar yerleştirin (örneğin, keywordBuilder.withText("[hardcover books]")).

Bağımsız değişken

Name	Tür	Açıklama
Metin	Dize	Anahtar sözcüğün metni. Anahtar sözcüğün metni gereklidir. Metin en fazla 100 karakter içerebilir. Reklam grubunun dil değerinin yerel ayarındaki metni belirtin.

Döndürür

Tür	Açıklama
KeywordBuilder	Anahtar sözcük metninin uygulandığı anahtar sözcük oluşturucusu.

withTrackingTemplate(dize izlemeTemplate)

Anahtar sözcüğün 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	Bu anahtar sözcükle kullanılacak izleme şablonu.

Döndürür

Tür	Açıklama
KeywordBuilder	İzleme şablonunun uygulandığı anahtar sözcük oluşturucusu.