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. |
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin