Aracılığıyla paylaş

AssetGroupSelector

Varlık gruplarının listesini filtreleme ve sıralama yöntemlerini içerir. Seçiciler hakkında 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ı Dönüş Türü Açıklama
Al AssetGroupIterator Varlık grupları listesinde yineleme yapmak için kullanılan bir yineleyici alır.
orderBy(string orderBy) AssetGroupSelector Belirtilen sıralamayı seçili varlık gruplarına uygular.
withCondition(dize koşulu) AssetGroupSelector Varlık gruplarına filtre ölçütleri uygular.
withIds(string[] ids) AssetGroupSelector Belirtilen kimliklere sahip varlık gruplarını alır.
withLimit(int sınırı) AssetGroupSelector Seçim ölçütlerine uyan ilk n varlık grubunu alır.

Al

Varlık grupları listesinde yineleme yapmak için kullanılan bir yineleyici alır.

Döndürür

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

orderBy(String orderBy)

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

withCondition(Dize koşulu)

Varlık gruplarına filtre ölçütleri uygular.

koşul parametresini şu şekilde belirtin: "columnName işleç değeri":

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

Varlık grubu 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.
To ç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
Durum sayım Varlık grubunun durumu. Büyük/küçük harfe duyarlı olası değerler şunlardır:
  • ETKİN
  • DURAKLATILDI
  • KALDIRILDI
Bu örnek yalnızca etkin varlık gruplarını döndürür.

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

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

withCondition("CampaignName CONTAINS_IGNORE_CASE 'truck'")
KeywordMaxCpc çift Varlık grubunun TBM teklifi. Teklif, hesabın para birimindedir.

withCondition("KeywordMaxCpc > 5.0")
CampaignStatus sayım Kampanyanın durumu. Büyük/küçük harfe duyarlı olası değerler şunlardır:
  • ETKİN
  • DURAKLATILDI
  • KALDIRILDI
Bu örnek yalnızca ana kampanya duraklatılmış varlık gruplarını döndürür.

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

withCondition("LabelNames CONTAINS_ANY ['bar', 'foo']")
CampaignType sayım 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 ana kampanya türü Alışveriş olan varlık gruplarını döndürür.

withCondition("CampaignType = SHOPPING")

Bağımsız değişken

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

Döndürür

Tür Açıklama
AssetGroupSelector Koşulun uygulandığı seçici.

withIds(string[] ids)

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

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

Bağımsız değişken

Name Tür Açıklama
Kimlik string[] Varlık grubu kimlikleri dizisi. Sınırlar için bkz. Betik yürütme sınırları.

Döndürür

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

withLimit(int sınırı)

Seçim ölçütlerine uyan ilk n varlık grubunu alır.

Bağımsız değişken

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.

Döndürür

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

Ayrıca bkz.

Campaign.assetGroups()

  • Last updated on