Anahtar Sözcük Seçici

Anahtar sözcük listesini filtreleme ve sıralama yöntemlerini içerir. Seçiciler hakkında daha fazla bilgi için bkz: Seçiciler.

Örnek kullanım:

    var iterator = AdsApp.keywords()
        .withCondition("AdGroupName = 'AD GROUP NAME GOES HERE'")
        .withCondition("CampaignName = 'CAMPAIGN NAME GOES HERE'")
        .get();

    while (iterator.hasNext()) {
        var keyword = iterator.next();
    }

Yöntemler

Yöntem Adı İade Türü Açıklama
forDateRange(Object dateFrom, Object dateTo) Anahtar Sözcük Seçici Performans ölçümlerini seçmek için başlangıç ve bitiş tarihlerini uygular.
forDateRange(dize dateRange) Anahtar Sözcük Seçici Performans ölçümlerini seçmek için önceden tanımlanmış tarih aralığını uygular.
Almak Anahtar Sözcük Yineleyici Anahtar sözcük listesini yinelemek için kullanılan bir yineleyici alır.
orderBy(dize orderBy) Anahtar Sözcük Seçici Belirtilen sıralamayı seçilen anahtar sözcüklere uygular.
withCondition(dize koşulu) Anahtar Sözcük Seçici Filtre ölçütünü anahtar sözcüklere uygular.
withIds(string[] ids) Anahtar Sözcük Seçici Belirtilen kimliklere sahip anahtar sözcükleri alır.
withLimit(int limit) Anahtar Sözcük Seçici Seçim ölçütleriyle eşleşen ilk n anahtar sözcüğü alır.

forDateRange(Object dateFrom, Object dateTo)

Performans ölçümlerini seçmek için başlangıç ve bitiş tarihlerini uygular.

Tarih aralığını yalnızca aşağıdaki koşullarda belirtin:

  • Performans ölçümü alanlarına başvuran koşullar veya sıralama uygularsınız.
  • Seçtiğiniz nesneler için performans verilerini almak istiyorsunuz. Örneğin, yöntemi çağırmayı getStats() planlıyorsanız.

Dizeleri veya nesneleri kullanarak tarih parametrelerini belirtebilirsiniz. Dizeleri kullanmak için, YYYYAAGG biçiminde tarihi belirtin. Nesneler kullanıyorsanız, aşağıdaki alanlarla bir nesne oluşturun:

  • 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.

Tarih aralığı kapsayıcıdır. Birden çok tarih aralığı belirtirseniz, yalnızca son tarih aralığı kullanılır.

Bağımsız değişkenler

Name Tür Açıklama
dateFrom Nesne Seçiciye eklenecek performans verilerini belirten tarih aralığının başlangıç tarihi.
dateEnd Nesne Seçiciye eklenecek performans verilerini belirten tarih aralığının bitiş tarihi.

Geri dönüşler

Tür Açıklama
Anahtar Sözcük Seçici Tarih aralığı uygulanmış seçici.

forDateRange(Dize dateRange)

Performans ölçümlerini seçmek için önceden tanımlanmış tarih aralığını uygular.

Desteklenen tarih aralığı değerleri:

  • BUGÜN
  • DÜN
  • LAST_WEEK
  • LAST_BUSINESS_WEEK
  • LAST_7_DAYS
  • THIS_WEEK_SUN_TODAY
  • LAST_14_DAYS
  • LAST_30_DAYS
  • LAST_WEEK_SUN_SAT
  • THIS_MONTH
  • LAST_MONTH
  • ALL_TIME

Tarih aralığını yalnızca aşağıdaki koşullarda belirtin:

  • Performans ölçümü alanlarına başvuran koşullar veya sıralama uygularsınız.
  • Seçtiğiniz nesneler için performans verilerini almak istiyorsunuz. Örneğin, yöntemi çağırmayı getStats() planlıyorsanız.

Birden çok tarih aralığı belirtirseniz, yalnızca son tarih aralığı kullanılır.

Bağımsız değişkenler

Name Tür Açıklama
tarih aralığı Dize Seçiciye eklenecek performans verilerini belirten önceden tanımlanmış tarih aralığı dizesi. Önceden tanımlanmış tarih aralığı dizesi büyük/küçük harfe duyarlıdır.

Geri dönüşler

Tür Açıklama
Anahtar Sözcük Seçici Tarih aralığı uygulanmış seçici.

Almak

Anahtar sözcük listesini yinelemek için kullanılan bir yineleyici alır.

Geri dönüşler

Tür Açıklama
Anahtar Sözcük Yineleyici Seçili anahtar sözcükleri yinelemek için kullanılan bir yineleyici.

orderBy(dize orderBy)

Belirtilen sıralamayı seçilen anahtar sözcüklere uygular.

orderBy parametresini "columnName orderDirection" biçiminde belirtin; burada:

  • columnNamedesteklenen sütunlardan biridir.
  • orderDirection , sonuçların sıralandığı sıradır. Sonuçları azalan sırada sıralamak için ASC olarak veya sonuçları azalan sırada sıralamak için DESC olarak ayarlayın. Varsayılan değer ASC'dir.

Örneğin, aşağıdaki çağrı sonuçları AverageCpc'ye göre artan sırada döndürür.

selector = selector.orderBy("AverageCpc");

Seçiciler, varlıkları yalnızca bir alana göre sıralamayı destekler. Varlıkların listesini x alanına göre ve x içinde y alanına göre sıralayamazsınız. Bir zincirde veya ayrı seçici çağrılarında birden fazla orderBy() çağrı belirtirseniz, Betikler son orderBy() çağrıda belirtilen alanı kullanarak varlıkların listesini sıralar. 

Bağımsız değişkenler

Name Tür Açıklama
orderBy dize Uygulanacak sipariş.

Geri dönüşler

Tür Açıklama
Anahtar Sözcük Seçici Sıralama uygulanmış seçici.

withCondition(Dize koşulu)

Filtre ölçütünü anahtar sözcüklere uygular.

"columnName işleç değeri" biçiminde koşul parametresini belirtin, burada:

Operatörler

Kullandığınız işleç, sütunun türüne bağlıdır. İşleçler büyük/küçük harf kullanımına duyarlıdır. Örneğin, starts_with yerine STARTS_WITH kullanın.

Tamsayılar ve uzun değerler içeren sütunlar için işleçler:

<
<=
>
>=
=
!=

Çift değer içeren sütunların işleçleri:

<
>

Dize değerleri içeren sütunların işleçleri:

=
!=
STARTS_WITH
STARTS_WITH_IGNORE_CASE
CONTAINS
CONTAINS_IGNORE_CASE
DOES_NOT_CONTAIN
DOES_NOT_CONTAIN_IGNORE_CASE

Numaralandırma değerleri içeren sütunların işleçleri:

=
!=
IN []
NOT_IN []

Bir dize dizisi içeren sütunların işleçleri:

CONTAINS_ALL
CONTAINS_ANY
CONTAINS_NONE

Anahtar sözcük filtreleme için desteklenen sütunlar. Sütun adları büyük/küçük harf duyarlıdır.

Aşağıdakiler, belirtebileceğiniz performans ölçümleri sütunlarıdır.

Sütun Tür Örnek Microsoft Advertising web kullanıcı arabirimi filtresi
AbsoluteTopImpressionRate çift kişilik withCondition("AbsoluteTopImpressionRate > 0.25") Abs. Üst Göstr. Oranı
Ortalama Cpc çift kişilik withCondition("AverageCpc < 2.75") Ort. TBM
Ortalama Cpm çift kişilik withCondition("AverageCpm > 0.65") Ort. BGBM
Tıklama Dönüşüm Oranı çift kişilik withCondition("ClickConversionRate > 0.25") Dönüşüm Oranı
Tıklamalar uzun withCondition("Clicks >= 33") Tıklamalar
Dönüştürülen Tıklamalar uzun withCondition("ConvertedClicks >= 10") Dönş.
Ücret çift kişilik withCondition("Cost > 3.25")

Maliyet, hesabın para birimi cinsindendir.		 Harcamak
CTR çift kişilik withCondition("Ctr > 0.05")

TO 0..1 aralığındadır, bu nedenle %5'lik bir TO için 0,05'i kullanın.		 TO (Tıklama Oranı)
İzlenimler uzun withCondition("Impressions > 10") Öğr.
En İyi Gösterim Oranı çift kişilik withCondition("TopImpressionRate > 0.25") Üst Göstr. Oranı

Aşağıdakiler, belirtebileceğiniz varlık özellikleridir.

Sütun Tür Örnek Microsoft Advertising web kullanıcı arabirimi filtresi
Durum numaralandırma Anahtar sözcüğün durumu. Büyük/küçük harfe duyarlı olası değerler şunlardır:
  • ETKİNLEŞTİRİLDİ
  • DURAKLATILDI
  • KALDIRILDI
withCondition("Status = ENABLED")		 Durum
CombinedApprovalStatus dize Anahtar sözcüğün onay durumu. Büyük/küçük harfe duyarlı olası değerler şunlardır:
  • ONAYLANDI
  • APPROVED_LIMITED
  • UNDER_REVIEW
  • ONAYLANMADI
Bu değerler hakkında bilgi için bkz. Editör onayı durum değerleri.

Bu örnek, dikkat edilmesi gereken anahtar kelimeleri döndürür.

withCondition("CombinedApprovalStatus IN ['APPROVED_LIMITED', 'DISAPPROVED']")
Metin dize Anahtar sözcüğün metni. Yalnızca anahtar sözcüğün metnini ekleyin. Anahtar kelimenin eşleme türünü metne eklemeyin. Örneğin, anahtar kelime [kitaplar] gibi tam eşlemeli bir anahtar kelimeyse, [kitaplar] yerine kitaplar kullanın.

withCondition("Text STARTS_WITH 'flowers'")		 Anahtar Sözcük Metni
Anahtar KelimeEşleşme Türü numaralandırma Anahtar kelimenin eşleme türü. Büyük/küçük harfe duyarlı olası değerler şunlardır:
  • GENİŞ
  • KESİN
  • İFADE
withCondition("KeywordMatchType = EXACT")		 Eşleşme türü
MaxCpc (Cihaz) çift kişilik Anahtar kelimenin maksimum TBM teklifi tutarı. TBM, hesabın para birimi cinsindendir.

withCondition("MaxCpc > 0.40")		 Teklif
Hedef Url dize withCondition("DestinationUrl STARTS_WITH 'http://www.contoso.com'") Hedef URL
FinalUrl'ler dize withCondition("FinalUrls CONTAINS 'http://www.contoso.com'")
Kalite Puanı int withCondition("QualityScore > 5") Nitelik. Puan
FirstPageCpc çift kişilik Bir reklamverenin, kenar çubuğunda göründüğünde reklamı her tıklandığında ücretlendirildiği ortalama tutar. Örneğin, bir reklamveren 300 tıklama için toplam 48,35 TL ödediyse, reklamverenin ortalama TBM'si 0,16 TL'dir. Reklamınızın kenar çubuğunda gösterilme şansını artırmak için anahtar kelime teklifinizi artırıp artırmayacağınıza karar vermenize yardımcı olması için bu bilgileri kullanın. TBM, hesabın para birimi cinsindendir.

withCondition("FirstPageCpc > 6.00")		 Öğr. İlk sayfa teklifi
TopOfPageCpc çift kişilik Bir reklamverenin, organik arama sonuçlarının üzerinde göründüğünde, reklamı her tıklandığında ücretlendirildiği ortalama tutar. Örneğin, bir reklamveren 300 tıklama için toplam 48,35 TL ödediyse, reklamverenin ortalama TBM'si 0,16 TL'dir. Reklamınızın organik arama sonuçlarının üzerinde gösterilme şansını artırmak için anahtar kelime teklifinizi artırıp artırmayacağınıza karar vermenize yardımcı olması için bu bilgileri kullanın. TBM, cari hesabın para birimi cinsindendir.

withCondition("TopOfPageCpc > 8.00")		 En iyi pozisyon
AdGroupName dize Anahtar kelimeleri içeren reklam grubunun adı.

withCondition("AdGroupName = 'foo'")
AdGroupStatus numaralandırma Reklam grubunun durumu. Büyük/küçük harfe duyarlı olası değerler şunlardır:
  • ETKİNLEŞTİRİLDİ
  • DURAKLATILDI
  • KALDIRILDI
withCondition("AdGroupStatus = ENABLED")
Kampanya Adı dize Anahtar sözcükleri içeren kampanyanın adı.

withCondition("CampaignName = 'bar'")
Kampanya Durumu numaralandırma Kampanyanın durumu. Büyük/küçük harfe duyarlı olası değerler şunlardır:
  • ETKİNLEŞTİRİLDİ
  • DURAKLATILDI
  • KALDIRILDI
withCondition("CampaignStatus = ENABLED")
Etiket Adları dize kümesi Bir veya birden çok büyük/küçük harfe duyarlı etiket adının listesi. Adlandırılmış etiketlerle ilişkilendirilmiş anahtar sözcükleri almak için kullanın.

withCondition("LabelNames CONTAINS_ANY ['bar', 'foo']")
Kimlik Uzun Test edilecek anahtar sözcüğün kimliği. Örneğin, belirtilen kimlikten daha büyük kimliklere sahip anahtar kelimeleri kontrol etmek için bu sütunu kullanabilirsiniz.

withCondition('Id > 1234')

Bağımsız değişkenler

Name Tür Açıklama
Şart dize Seçiciye eklenecek koşul.

Geri dönüşler

Tür Açıklama
Anahtar Sözcük Seçici Uygulanan koşulla seçici.

withIds(string[] ids)

Belirtilen kimliklere sahip anahtar sözcükleri alır.

Bir seçiciye bir veya daha fazla koşul uygulayabilirsiniz. Koşullar zinciri AND işlemi olarak kabul edilir. Örneğin, varlık yalnızca A koşulu doğruysa VE B koşulu doğruysa seçilir. Örneğin, aşağıdaki çağrı yalnızca 33333 anahtar sözcüğünü seçer.

AdsApp.keywords()
    .withIds(['11111', '22222', '33333'])
    .withIds(['33333', '44444', '55555']);

Bağımsız değişkenler

Name Tür Açıklama
kimlikler dize[] Anahtar sözcük kimlikleri dizisi. Sınırlar için bkz: Komut dosyası yürütme sınırları.

Geri dönüşler

Tür Açıklama
Anahtar Sözcük Seçici Kimliklerin uygulandığı seçici.

withLimit(int limit)

Seçim ölçütleriyle eşleşen ilk n anahtar sözcüğü alır.

Bağımsız değişkenler

Name Tür Açıklama
sınırlamak int Döndürülecek anahtar sözcük sayısı. Gerçek sayı daha az olabilir.

Geri dönüşler

Tür Açıklama
Anahtar Sözcük Seçici Sınır uygulanmış seçici.

Ayrıca bkz.

  • Last updated on