Aracılığıyla paylaş


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.