AssetGroupSelector

Varlık grupları listesini filtrelemek ve sıralamak için yöntemleri içerir. Seçiciler hakkında daha fazla bilgi için bkz: Seçiciler.

Örnek kullanım:

    var iterator = Campaign.assetGroups()
        .withCondition("ClickConversionRate > 0.3")
        .forDateRange("LAST_WEEK")
        .orderBy("Clicks DESC")
        .get();

    while (iterator.hasNext()) {
        var assetGroup = iterator.next();
        var metrics = assetGroup.getStats();
    }

Yöntemler

Yöntem Adı İade Türü Açıklama
Almak AssetGroupYineleyici Varlık grupları listesini yinelemek için kullanılan bir yineleyici alır.
orderBy(dize orderBy) AssetGroupSelector Belirtilen sıralamayı seçili varlık gruplarına uygular.
withCondition(dize koşulu) AssetGroupSelector Filtre ölçütlerini varlık gruplarına uygular.
withIds(string[] ids) AssetGroupSelector Belirtilen kimliklere sahip varlık gruplarını alır.
withLimit(int limit) AssetGroupSelector Seçim ölçütleriyle eşleşen ilk n varlık grubunu alır.

Almak

Varlık grupları listesini yinelemek için kullanılan bir yineleyici alır.

Geri dönüşler

Tür Açıklama
AssetGroupYineleyici Seçili varlık grupları arasında yineleme yapmak için kullanılan yineleyici.

orderBy(String orderBy)

Belirtilen sıralamayı seçili varlık gruplarına 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ı varlık gruplarını 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
AssetGroupSelector Sıralama uygulanmış seçici.

withCondition(Dize koşulu)

Filtre ölçütlerini varlık gruplarına 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

Desteklenen Sütunlar

Varlık grubu filtrelemesi için desteklenen sütunlar. Adlar büyük/küçük harfe duyarlıdır.

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

Sütun Tür Örnek
AbsoluteTopImpressionRate çift kişilik withCondition("AbsoluteTopImpressionRate > 0.25")
Ortalama Cpc çift kişilik withCondition("AverageCpc < 2.75")
Ortalama Cpm çift kişilik withCondition("AverageCpm > 0.65")
Tıklama Dönüşüm Oranı çift kişilik withCondition("ClickConversionRate > 0.25")
Tıklamalar uzun withCondition("Clicks >= 33")
Dönüştürülen Tıklamalar uzun withCondition("ConvertedClicks >= 10")
Ücret çift kişilik withCondition("Cost > 3.25")

Maliyet, hesabın para birimi cinsindendir.
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.
İzlenimler uzun withCondition("Impressions > 10")
En İyi Gösterim Oranı çift kişilik withCondition("TopImpressionRate > 0.25")

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

Sütun Tür Örnek
Durum numaralandırma Varlık grubunun durumu. Büyük/küçük harfe duyarlı olası değerler şunlardır:
  • ETKİNLEŞTİRİLDİ
  • DURAKLATILDI
  • KALDIRILDI
Bu örnekte yalnızca etkinleştirilmiş varlık grupları döndürülür.

withCondition("Status = ENABLED")
Name dize Varlık grubunun adı.

withCondition("Name CONTAINS_IGNORE_CASE 'sport'")
Kampanya Adı dize Kampanyanın adı.

withCondition("CampaignName CONTAINS_IGNORE_CASE 'truck'")
Anahtar kelimeMaxCpc çift kişilik Öğe grubunun TBM teklifi. Teklif, hesabın para birimi cinsindendir.

withCondition("KeywordMaxCpc > 5.0")
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
Bu örnek, yalnızca ana kampanyası duraklatılmış olan öğe gruplarını döndürür.

withCondition("CampaignStatus = PAUSED")
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ş varlık gruplarını almak için kullanın.

withCondition("LabelNames CONTAINS_ANY ['bar', 'foo']")
Kampanya Türü numaralandırma Kampanyanın türü. Büyük/küçük harfe duyarlı olası değerler şunlardır:
  • SEARCH_AND_CONTENT
  • ALIŞVERİŞ
  • DYNAMIC_SEARCH_ADS
Bu örnek, yalnızca üst kampanya türü Alışveriş olan öğe gruplarını döndürür.

withCondition("CampaignType = SHOPPING")

Bağımsız değişkenler

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

Geri dönüşler

Tür Açıklama
AssetGroupSelector Uygulanan koşulla seçici.

withIds(string[] ids)

Belirtilen kimliklere sahip varlık gruplarını 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 varlık grubunu seçer.

var selector = Campaign.assetGroups()
    .withIds(['11111', '22222', '33333'])
    .withIds(['33333', '44444', '55555']);

Bağımsız değişkenler

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

Geri dönüşler

Tür Açıklama
AssetGroupSelector Kimliklerin uygulandığı seçici.

withLimit(int limit)

Seçim ölçütleriyle eşleşen ilk n varlık grubunu alır.

Bağımsız değişkenler

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

Geri dönüşler

Tür Açıklama
AssetGroupSelector Sınır uygulanmış seçici.

Ayrıca bkz.

Campaign.assetGroups()

  • Last updated on