BudgetSelector
Paylaşılan bütçe 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.budgets()
.withCondition("ClickConversionRate > 0.3")
.forDateRange("LAST_WEEK")
.orderBy("Clicks DESC")
.get();
while (iterator.hasNext()) {
var budget = iterator.next();
var metrics = budget.getStats();
}
Yöntemler
| Yöntem Adı | Dönüş Türü | Açıklama |
|---|---|---|
| forDateRange(Object dateFrom, Object dateTo) | BudgetSelector | Performans ölçümlerini seçmek için başlangıç ve bitiş tarihlerini uygular. |
| forDateRange(string dateRange) | BudgetSelector | Performans ölçümlerini seçmek için önceden tanımlanmış tarih aralığını uygular. |
| Al | AdGroupIterator | Paylaşılan bütçeler listesinde yineleme yapmak için kullanılan bir yineleyici alır. |
| orderBy(string orderBy) | BudgetSelector | Seçilen paylaşılan bütçelere belirtilen sıralamayı uygular. |
| withCondition(dize koşulu) | BudgetSelector | Paylaşılan bütçelere filtre ölçütleri uygular. |
| withIds(string[] ids) | BudgetSelector | Belirtilen kimliklerle paylaşılan bütçeleri alır. |
| withLimit(int sınırı) | BudgetSelector | Seçim ölçütleriyle eşleşen ilk n paylaşılan bütçeyi 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 |
|---|---|
| BudgetSelector | Tarih aralığı uygulanmış seçici. |
forDateRange(String dateRange)
Performans ölçümlerini seçmek için önceden tanımlanmış tarih aralığını 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.
Birden çok tarih aralığı belirtirseniz, yalnızca son tarih aralığı kullanılır.
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
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 |
|---|---|
| BudgetSelector | Tarih aralığı uygulanmış seçici. |
Al
Paylaşılan bütçeler listesinde yineleme yapmak için kullanılan bir yineleyici alır.
Döndürür
| Tür | Açıklama |
|---|---|
| AdGroupIterator | Seçilen paylaşılan bütçeleri yinelemek için kullanılan bir yineleyici. |
orderBy(String orderBy)
Seçilen paylaşılan bütçelere 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ı paylaşılan bütçeleri 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 |
|---|---|
| BudgetSelector | Sıralama uygulanmış seçici. |
withCondition(Dize koşulu)
Paylaşılan bütçelere 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
Desteklenen Sütunlar
Paylaşılan bütçe filtreleme için desteklenen sütunlar. 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 |
|---|---|---|
| AbsoluteTopImpressionRate | Çift | withCondition("AbsoluteTopImpressionRate > 0.25") |
| AverageCpc | Çift | withCondition("AverageCpc < 2.75") |
| AverageCpm | Çift | withCondition("AverageCpm > 0.65") |
| ClickConversionRate | Çift | withCondition("ClickConversionRate > 0.25") |
| Tıklama | Uzun | withCondition("Clicks >= 33") |
| ConvertedClicks | Uzun | withCondition("ConvertedClicks >= 10") |
| Ücret | Çift | withCondition("Cost > 3.25")Maliyet, hesabın para birimindedir. |
| Ctr | Çift | withCondition("Ctr > 0.05")CTR 0..1 aralığındadır, bu nedenle %5 CTR için 0,05 kullanın. |
| Gösterim | Uzun | withCondition("Impressions > 10") |
| TopImpressionRate | Çift | withCondition("TopImpressionRate > 0.25") |
Aşağıda, belirteceğiniz varlık özellikleri yer alır.
| Sütun | Tür | Örnek |
|---|---|---|
| Tutar | Çift | Paylaşılan bütçenin tutarı.withCondition("Amount >= 130") |
| BudgetName | Dize | Paylaşılan bütçenin adı.withCondition("BudgetName CONTAINS_IGNORE_CASE 'sport'") |
| BudgetReferenceCount | Tamsayı | Paylaşılan bütçeyle ilişkilendirilmiş kampanyaların sayısı.withCondition("BudgetReferenceCount > 5") |
Bağımsız değişken
| Name | Tür | Açıklama |
|---|---|---|
| Durum | Dize | Seçiciye uygulanacak koşul. |
Döndürür
| Tür | Açıklama |
|---|---|
| BudgetSelector | Koşulun uygulandığı seçici. |
withIds(string[] ids)
Belirtilen kimliklerle paylaşılan bütçeleri 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 paylaşılan bütçe 33333'i seçer.
var selector = AdsApp.budgets()
.withIds(['11111', '22222', '33333'])
.withIds(['33333', '44444', '55555']);
Bağımsız değişken
| Name | Tür | Açıklama |
|---|---|---|
| Kimlik | string[] | Paylaşılan bütçe kimlikleri dizisi. Sınırlar için bkz. Betik yürütme sınırları. |
Döndürür
| Tür | Açıklama |
|---|---|
| BudgetSelector | Kimliklerin uygulandığı seçici. |
withLimit(int sınırı)
Seçim ölçütleriyle eşleşen ilk n paylaşılan bütçeyi alır.
Bağımsız değişken
| Name | Tür | Açıklama |
|---|---|---|
| Sınırı | Int | Döndürülecek paylaşılan bütçelerin sayısı. Gerçek sayı daha az olabilir. |
Döndürür
| Tür | Açıklama |
|---|---|
| BudgetSelector | Sınır uygulanmış seçici. |