Aracılığıyla paylaş

UserListSelector

  • Makale

Hesaptaki kullanıcı listelerini filtreleme ve sıralama yöntemlerini içerir. Seçiciler hakkında bilgi için bkz. Seçiciler.

Yöntemler

Yöntem Adı Dönüş Türü Açıklama
Al UserListIterator Kullanıcı listeleri listesinde yineleme yapmak için kullanılan bir yineleyici alır.
orderBy(string orderBy) UserListSelector Belirtilen sıralamayı seçili kullanıcı listelerine uygular.
withCondition(dize koşulu) UserListSelector Filtre ölçütlerini kullanıcı listelerine uygular.
withIds(string[] ids) UserListSelector Belirtilen kimliklere sahip kullanıcı listelerini alır.
withLimit(int sınırı) UserListSelector Seçim ölçütlerine uyan ilk n kullanıcı listesini alır.

Al

Kullanıcı listeleri listesinde yineleme yapmak için kullanılan bir yineleyici alır.

Döndürür

Tür Açıklama
UserListIterator Seçili kullanıcı listelerinde yinelemek için kullanılan bir yineleyici.

orderBy(string orderBy)

Belirtilen sıralamayı seçili kullanıcı listelerine uygular.

"columnName orderDirection" biçiminde orderBy parametresini belirtin. Burada:

  • columnName , [desteklenen sütunlardan](#supported-user list-columns) 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ı kullanıcı listesinin adına göre artan sırada döndürür.

selector = selector.orderBy("Name");

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
UserListSelector Sıralama uygulanmış seçici.

withCondition(Dize koşulu)

Filtre ölçütlerini kullanıcı listelerine uygular.

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

  • columnName , [desteklenen sütunlardan](#supported-user list-columns) biridir.
  • 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

Kullanıcı listesi filtrelemesi için desteklenen sütunlar. Sütun adları büyük/küçük harfe duyarlıdır.

Sütun Tür Örnek
Açıklama Dize Kullanıcı listesinin açıklaması.

withCondition("Description = 'foo'")
MembershipLifeSpan Int Microsoft Advertising'in bu kullanıcı listesi tanımıyla eşleşen eylemleri ne kadar geriye (gün sayısı) araması gerekir.

withCondition("MembershipLifeSpan > 10")
Name Dize Kullanıcı listesinin adı.

withCondition("Name = 'foo'")
SizeForAudienceNetwork Uzun Hedef kitle ağındaki kullanıcı listesinin boyutu.

withCondition("SizeForAudienceNetwork > 1000")
SizeForSearch Uzun Hedef kitle ağındaki kullanıcı listesinin boyutu.

withCondition("SizeForSearch > 1000")
Tür Dize Kullanıcı listesinin türetilmiş türü. Büyük/küçük harfe duyarlı olası değerler şunlardır:
  • ÖZEL
  • CUSTOMER_LIST
  • IN_MARKET
  • MANTIKSAL
  • ÜRÜN
  • RULE_BASED
  • BENZER
Bu örnek yalnızca müşteri listelerini döndürür.

withCondition("Type = CUSTOMER_LIST")

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
UserListSelector Koşulun uygulandığı seçici.

withIds(string[] ids)

Belirtilen kimliklere sahip kullanıcı listelerini 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 kullanıcı listesini seçer.

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

Bağımsız değişken

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

Döndürür

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

withLimit(int sınırı)

Seçim ölçütlerine uyan ilk n kullanıcı listesini alır.

Bağımsız değişken

Name Tür Açıklama
Sınırı Int Döndürülecek kullanıcı listesi sayısı. Gerçek sayı daha az olabilir.

Döndürür

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

Ayrıca bkz.