UserListSelector

Contiene i metodi per filtrare e ordinare un elenco di elenchi di utenti nell'account. Per informazioni sui selettori, vedere Selettori.

Metodi

Nome metodo Tipo restituito Descrizione
Ottieni UserListIterator Ottiene un iteratore usato per scorrere l'elenco degli elenchi di utenti.
orderBy(stringa orderBy) UserListSelector Applica l'ordinamento specificato agli elenchi di utenti selezionati.
withCondition(condizione stringa) UserListSelector Applica i criteri di filtro agli elenchi di utenti.
withIds(string[] ids) UserListSelector Consente di ottenere elenchi di utenti con gli ID specificati.
withLimit(int limit) UserListSelector Ottiene i primi n elenchi di utenti che corrispondono ai criteri di selezione.

Ottieni

Ottiene un iteratore usato per scorrere l'elenco degli elenchi di utenti.

Restituisce

Tipo Descrizione
UserListIterator Un iteratore utilizzato per scorrere gli elenchi di utenti selezionati.

orderBy(stringa orderBy)

Applica l'ordinamento specificato agli elenchi di utenti selezionati.

Specificare il parametro orderBy nel modulo "columnName orderDirection" dove:

  • columnName è una delle [colonne supportate](#supported-user-list-columns).
  • orderDirection è l'ordine in cui ordinare i risultati. Impostate su ASC per ordinare i risultati in ordine crescente o DESC per ordinare i risultati in ordine decrescente. L'impostazione predefinita è ASC.

Ad esempio, la chiamata seguente restituisce i risultati in ordine crescente in base al nome dell'elenco di utenti.

selector = selector.orderBy("Name");

I selettori supportano l'ordinamento delle entità in base a un solo campo. Non è possibile ordinare l'elenco delle entità in base al campo x e all'interno di x in base al campo y e così via. Se si specificano orderBy() più chiamate in una catena o in chiamate di selezione separate, Scripts ordina l'elenco delle entità utilizzando il campo specificato nell'ultima orderBy() chiamata. 

Argomenti

Nome Tipo Descrizione
orderBy stringa Ordine da applicare.

Restituisce

Tipo Descrizione
UserListSelector Selettore con ordinamento applicato.

withCondition(condizione stringa)

Applica i criteri di filtro agli elenchi di utenti.

Specificare il parametro condizione nel formato "valore operatore columnName" dove:

  • columnName è una delle [colonne supportate](#supported-user-list-columns).
  • operator è uno degli operatori supportati.

Operatori

L'operatore da usare dipende dal tipo di colonna. Negli operatori viene fatta distinzione tra maiuscole e minuscole. Ad esempio, usare STARTS_WITH invece di starts_with.

Operatori per le colonne che contengono numeri interi e lunghi:

<
<=
>
>=
=
!=

Operatori per le colonne che contengono valori double:

<
>

Operatori per le colonne che contengono valori stringa:

=
!=
STARTS_WITH
STARTS_WITH_IGNORE_CASE
CONTAINS
CONTAINS_IGNORE_CASE
DOES_NOT_CONTAIN
DOES_NOT_CONTAIN_IGNORE_CASE

Operatori per le colonne che contengono valori di enumerazione:

=
!=
IN []
NOT_IN []

Operatori per le colonne che contengono una matrice di stringhe:

CONTAINS_ALL
CONTAINS_ANY
CONTAINS_NONE

Colonne supportate per il filtro dell'elenco di utenti. Nei nomi delle colonne viene fatta distinzione tra maiuscole e minuscole.

Colonna Tipo Esempio
Descrizione stringa Descrizione dell'elenco di utenti.

withCondition("Description = 'foo'")
MembershipLifeSpan int L'intervallo di tempo precedente (numero di giorni) in Microsoft Advertising deve cercare le azioni che corrispondono a questa definizione dell'elenco di utenti.

withCondition("MembershipLifeSpan > 10")
Nome stringa Nome dell'elenco di utenti.

withCondition("Name = 'foo'")
SizeForAudienceNetwork long Dimensioni dell'elenco di utenti nella rete di gruppi di destinatari.

withCondition("SizeForAudienceNetwork > 1000")
SizeForSearch long Dimensioni dell'elenco di utenti nella rete di gruppi di destinatari.

withCondition("SizeForSearch > 1000")
Tipo stringa Tipo derivato dell'elenco di utenti. I valori possibili con distinzione tra maiuscole e minuscole sono:
  • PERSONALIZZATO
  • CUSTOMER_LIST
  • IN_MARKET
  • LOGICO
  • PRODOTTO
  • RULE_BASED
  • SIMILI
In questo esempio vengono restituiti solo elenchi di clienti.

withCondition("Type = CUSTOMER_LIST")

Argomenti

Nome Tipo Descrizione
condizione stringa Condizione da aggiungere al selettore.

Restituisce

Tipo Descrizione
UserListSelector Selettore con la condizione applicata.

withIds(string[] ids)

Consente di ottenere elenchi di utenti con gli ID specificati.

Puoi applicare una o più condizioni a un selettore. Una catena di condizioni è considerata un'operazione AND. Ad esempio, l'entità viene selezionata solo se la condizione A è vera E la condizione B è vera. Ad esempio, la chiamata seguente seleziona solo l'elenco utenti 33333.

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

Argomenti

Nome Tipo Descrizione
ID stringa[] Matrice di ID elenco utenti. Per i limiti, vedere Limiti di esecuzione degli script.

Restituisce

Tipo Descrizione
UserListSelector Selettore con gli ID applicati.

withLimit(int limit)

Ottiene i primi n elenchi di utenti che corrispondono ai criteri di selezione.

Argomenti

Nome Tipo Descrizione
Limite int Numero di elenchi di utenti da restituire. Il numero effettivo potrebbe essere inferiore.

Restituisce

Tipo Descrizione
UserListSelector Selettore con limite applicato.

Vedere anche

  • Ultimo aggiornamento: