KeywordSelector
Bir anahtar sözcük listesini filtreleme ve sıralama yöntemlerini içerir. Seçiciler hakkında 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ı | Dönüş Türü | Açıklama |
---|---|---|
forDateRange(Object dateFrom, Object dateTo) | KeywordSelector | Performans ölçümlerini seçmek için başlangıç ve bitiş tarihlerini uygular. |
forDateRange(string dateRange) | KeywordSelector | Performans ölçümlerini seçmek için önceden tanımlanmış tarih aralığını uygular. |
Al | KeywordIterator | Anahtar sözcük listesinde yineleme yapmak için kullanılan bir yineleyici alır. |
orderBy(string orderBy) | KeywordSelector | Seçilen anahtar sözcüklere belirtilen sıralamayı uygular. |
withCondition(dize koşulu) | KeywordSelector | Anahtar sözcüklere filtre ölçütleri uygular. |
withIds(string[] ids) | KeywordSelector | Belirtilen kimliklerle anahtar sözcükleri alır. |
withLimit(int sınırı) | KeywordSelector | 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.
Yalnızca aşağıdakiler için bir tarih aralığı belirtin:
- Performans ölçümü alanlarına başvuran koşullar veya sıralama uygularsınız.
- Seçtiğiniz nesnelerin performans verilerini almak istiyorsunuz. Örneğin, yöntemini çağırmayı
getStats()
planlıyorsanız.
Dizeleri veya nesneleri kullanarak tarih parametrelerini belirtebilirsiniz. Dizeleri kullanmak için YYYYMMDD biçimindeki tarihi belirtin. Nesneleri kullanıyorsanız, aşağıdaki alanlara sahip 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şken
Name | Tür | Açıklama |
---|---|---|
dateFrom | Nesne | Seçiciye eklenecek performans verilerini belirten tarih aralığının başlangıç tarihi. |
dateTo | Nesne | Seçiciye eklenecek performans verilerini belirten tarih aralığının bitiş tarihi. |
Döndürür
Tür | Açıklama |
---|---|
KeywordSelector | Tarih aralığı uygulanmış seçici. |
forDateRange(String 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
Yalnızca aşağıdakiler için bir tarih aralığı belirtin:
- Performans ölçümü alanlarına başvuran koşullar veya sıralama uygularsınız.
- Seçtiğiniz nesnelerin performans verilerini almak istiyorsunuz. Örneğin, yöntemini çağırmayı
getStats()
planlıyorsanız.
Birden çok tarih aralığı belirtirseniz, yalnızca son tarih aralığı kullanılır.
Bağımsız değişken
Name | Tür | Açıklama |
---|---|---|
dateRange | 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. |
Döndürür
Tür | Açıklama |
---|---|
KeywordSelector | Tarih aralığı uygulanmış seçici. |
Al
Anahtar sözcük listesinde yineleme yapmak için kullanılan bir yineleyici alır.
Döndürür
Tür | Açıklama |
---|---|
KeywordIterator | Seçilen anahtar sözcükler arasında yineleme yapmak için kullanılan bir yineleyici. |
orderBy(string orderBy)
Seçilen anahtar sözcüklere belirtilen sıralamayı uygular.
"columnName orderDirection" biçiminde orderBy parametresini belirtin. Burada:
- columnNamedesteklenen sütunlardan biridir.
- orderDirection , sonuçları sıralama düzenidir. Sonuçları artan düzende sıralamak için ASC veya azalan düzende 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, x içinde y alanına göre sıralayamayabilirsiniz. Zincirde veya ayrı seçici çağrılarında birden orderBy()
fazla çağrı belirtirseniz, Betikler son orderBy()
çağrıda belirtilen alanı kullanarak varlık listesini sipariş eder.
Bağımsız değişken
Name | Tür | Açıklama |
---|---|---|
Orderby | Dize | Uygulanacak sipariş. |
Döndürür
Tür | Açıklama |
---|---|
KeywordSelector | Sıralama uygulanmış seçici. |
withCondition(Dize koşulu)
Anahtar sözcüklere filtre ölçütleri uygular.
koşul parametresini şu şekilde belirtin: "columnName işleç değeri":
- columnNamedesteklenen sütunlardan biridir. columName bir performans ölçümü sütun adına ayarlandıysa, forDateRange(String dateRange) veya forDateRange(Object dateFrom, Object dateTo) kullanarak bir tarih aralığı belirtmeniz gerekir.
- işleç desteklenen işleçlerden biridir.
Işleç
Kullandığınız işleç, sütunun türüne bağlıdır. İşleçler büyük/küçük harfe duyarlıdır. Örneğin, starts_with yerine STARTS_WITH kullanın.
Tamsayılar ve uzun değerler içeren sütunların işleçleri:
<
<=
>
>=
=
!=
Ç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 []
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 harfe duyarlıdır.
Aşağıda, belirteceğiniz performans ölçümleri sütunları yer alır.
Sütun | Tür | Örnek | Microsoft Advertising web kullanıcı arabirimi filtresi |
---|---|---|---|
AbsoluteTopImpressionRate | Çift | withCondition("AbsoluteTopImpressionRate > 0.25") |
Abs. Üst Impr. Oranı |
AverageCpc | Çift | withCondition("AverageCpc < 2.75") |
Ort. CPC |
AverageCpm | Çift | withCondition("AverageCpm > 0.65") |
Ortalama CPM |
ClickConversionRate | Çift | withCondition("ClickConversionRate > 0.25") |
Dışbükey Oran |
Tıklama | Uzun | withCondition("Clicks >= 33") |
Tıklama |
ConvertedClicks | Uzun | withCondition("ConvertedClicks >= 10") |
Dönş. |
Ücret | Çift | withCondition("Cost > 3.25") Maliyet, hesabın para birimindedir. |
Harcamak |
Ctr | Çift | withCondition("Ctr > 0.05") CTR 0..1 aralığındadır, bu nedenle %5 CTR için 0,05 kullanın. |
CTR |
Gösterim | Uzun | withCondition("Impressions > 10") |
Impr. |
TopImpressionRate | Çift | withCondition("TopImpressionRate > 0.25") |
Üst Impr. Oranı |
Aşağıda, belirteceğiniz varlık özellikleri yer alır.
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:
withCondition("Status = ENABLED") |
Durum |
CombinedApprovalStatus | Dize | Anahtar sözcüğün onay durumu. Büyük/küçük harfe duyarlı olası değerler şunlardır:
Bu örnek, dikkat gerektiren anahtar sözcükleri 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 sözcüğün eşleşme türünü metne eklemeyin. Örneğin, anahtar sözcük [kitaplar] gibi tam eşleşme anahtar sözcüğüyse, [kitaplar] değil kitapları kullanın.withCondition("Text STARTS_WITH 'flowers'") |
Anahtar Sözcük Metni |
KeywordMatchType | Numaralandırma | Anahtar sözcüğün eşleşme türü. Büyük/küçük harfe duyarlı olası değerler şunlardır:
withCondition("KeywordMatchType = EXACT") |
Eşleşme türü |
MaxCpc | Çift | Anahtar sözcüğün maksimum TBM teklifi tutarı. TBM hesabın para birimindedir.withCondition("MaxCpc > 0.40") |
Teklif |
DestinationUrl | Dize | withCondition("DestinationUrl STARTS_WITH 'http://www.contoso.com'") |
Hedef URL |
FinalUrls | Dize | withCondition("FinalUrls CONTAINS 'http://www.contoso.com'") |
|
QualityScore | Int | withCondition("QualityScore > 5") |
Kalite. Puan |
FirstPageCpc | Çift | Reklama her tıklandığında reklam verenin kenar çubuğunda gösterildiği ortalama ücretlendirme. Örneğin, bir reklamveren 300 tıklama için toplam 48,35 ABD doları ödediyse, reklamverenin ortalama CPC değeri 0,16 ABD dolarıdır. Reklamınızın kenar çubuğunda görünme olasılığını artırmak için anahtar sözcük teklifinizi artırıp artırmayacağınıza karar vermenize yardımcı olması için bu bilgileri kullanın. TBM hesabın para birimindedir.withCondition("FirstPageCpc > 6.00") |
Est. ilk sayfa teklifi |
TopOfPageCpc | Çift | Organik arama sonuçlarının üzerinde gösterildiğinde reklama her tıklandığında bir reklamverenden ortalama ücret alınır. Örneğin, bir reklamveren 300 tıklama için toplam 48,35 ABD doları ödediyse, reklamverenin ortalama CPC değeri 0,16 ABD dolarıdır. Reklamınızın organik arama sonuçlarının üzerinde görünme olasılığını artırmak için anahtar sözcük teklifinizi artırıp artırmayacağınıza karar vermenize yardımcı olması için bu bilgileri kullanın. TBM, geçerli hesabın para birimindedir.withCondition("TopOfPageCpc > 8.00") |
En iyi konum |
AdGroupName | Dize | Anahtar sözcükleri 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:
withCondition("AdGroupStatus = ENABLED") |
|
CampaignName | Dize | Anahtar sözcükleri içeren kampanyanın adı.withCondition("CampaignName = 'bar'") |
|
CampaignStatus | Numaralandırma | Kampanyanın durumu. Büyük/küçük harfe duyarlı olası değerler şunlardır:
withCondition("CampaignStatus = ENABLED") |
|
LabelNames | dize kümesi | Bir veya daha fazla 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 etmek için anahtar sözcüğün kimliği. Örneğin, belirtilen kimlikten büyük kimliklere sahip anahtar sözcükleri denetlemek için bu sütunu kullanabilirsiniz.withCondition('Id > 1234') |
Bağımsız değişken
Name | Tür | Açıklama |
---|---|---|
Durum | Dize | Seçiciye eklenecek koşul. |
Döndürür
Tür | Açıklama |
---|---|
KeywordSelector | Koşulun uygulandığı seçici. |
withIds(string[] ids)
Belirtilen kimliklerle anahtar sözcükleri alır.
Bir seçiciye bir veya daha fazla koşul uygulayabilirsiniz. Bir koşul 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şken
Name | Tür | Açıklama |
---|---|---|
Kimlik | string[] | Anahtar sözcük kimlikleri dizisi. Sınırlar için bkz. Betik yürütme sınırları. |
Döndürür
Tür | Açıklama |
---|---|
KeywordSelector | Kimliklerin uygulandığı seçici. |
withLimit(int sınırı)
Seçim ölçütleriyle eşleşen ilk n anahtar sözcüğü alır.
Bağımsız değişken
Name | Tür | Açıklama |
---|---|---|
Sınırı | Int | Döndürülecek anahtar sözcük sayısı. Gerçek sayı daha az olabilir. |
Döndürür
Tür | Açıklama |
---|---|
KeywordSelector | Sınır uygulanmış seçici. |