Condividi tramite

AdGroupExcludedAudienceSelector

Contiene i metodi per filtrare e ordinare un elenco di gruppi di destinatari esclusi dal gruppo di annunci. Per informazioni sui selettori, vedere Selettori.

Utilizzo di esempio:

    // Gets the iterator that iterates all ad group excluded audiences
    // in the account.
    var iterator = AdsApp.adGroups().get();

    // Loops through all ad groups in the account.
    while (iterator.hasNext()) {
        var adGroup = iterator.next();

        // Gets the iterator that iterates all ad group excluded audiences
        // in the ad group excluded audience.
        var audienceIterator = adGroup.targeting().audiences()
            .withLimit(10)
            .withIds("123456789")
            .get();
    
        // Loops through all ad group excluded audiences in the ad group excluded audience.
        while (audienceIterator.hasNext()) {
            var audience = audienceIterator.next();
        }
    }

Metodi

Nome metodo Tipo restituito Descrizione
Ottieni AdGroupExcludedAudienceIterator Ottiene un iteratore usato per scorrere l'elenco dei gruppi di destinatari esclusi dal gruppo di annunci.
orderBy(string orderBy) AdGroupExcludedAudienceSelector Applica l'ordinamento specificato ai gruppi di destinatari esclusi dal gruppo di annunci selezionato.
withCondition(string condition) AdGroupExcludedAudienceSelector Applica i criteri di filtro ai gruppi di destinatari esclusi dal gruppo di annunci.
withIds(string[] ids) AdGroupExcludedAudienceSelector Ottiene i gruppi di destinatari esclusi dal gruppo di annunci con gli ID specificati.
withLimit(int limit) AdGroupExcludedAudienceSelector Ottiene i primi n gruppi di destinatari esclusi dal gruppo di annunci che corrispondono ai criteri di selezione.

Ottieni

Ottiene un iteratore usato per scorrere l'elenco dei gruppi di destinatari esclusi dal gruppo di annunci.

Restituisce

Tipo Descrizione
AdGroupExcludedAudienceIterator Iteratore usato per scorrere i gruppi di destinatari esclusi dal gruppo di annunci selezionato.

orderBy(String orderBy)

Applica l'ordinamento specificato ai gruppi di destinatari esclusi dal gruppo di annunci selezionato.

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

  • columnName è una delle colonne supportate.
  • orderDirection è l'ordine in cui ordinare i risultati. Impostare su ASC per ordinare i risultati in ordine crescente o DESC per ordinare i risultati in ordine decrescente. Il valore predefinito è ASC.

Ad esempio, la chiamata seguente restituisce gruppi di destinatari esclusi dal gruppo di annunci in ordine crescente in base a AverageCpc.

selector = selector.orderBy("AverageCpc");

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

Argomenti

Nome Tipo Descrizione
Orderby stringa Ordinamento da applicare.

Restituisce

Tipo Descrizione
AdGroupExcludedAudienceSelector Selettore con ordinamento applicato.

withCondition(String condition)

Applica i criteri di filtro ai gruppi di destinatari esclusi dal gruppo di annunci.

Specificare il parametro condition nel formato "columnName operator value" dove:

Operatori

L'operatore usato dipende dal tipo della colonna. Gli operatori fanno distinzione tra maiuscole e minuscole. Ad esempio, usare STARTS_WITH anziché starts_with.

Operatori per le colonne che contengono valori interi e valori 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

Colonne supportate per il filtro dei gruppi di destinatari esclusi dal gruppo di annunci. I nomi fanno distinzione tra maiuscole e minuscole.

Di seguito sono riportate le proprietà dell'entità che è possibile specificare.

Colonna Tipo Esempio
AdGroupName stringa Nome del gruppo di annunci dell'associazione.

withCondition("AdGroupName CONTAINS_IGNORE_CASE 'truck'")
AdGroupStatus Enumerazione Stato del gruppo di annunci dell'associazione. I possibili valori con distinzione tra maiuscole e minuscole sono:
  • ABILITATO
  • PAUSA
  • RIMOSSO
Questo esempio restituisce solo i gruppi di destinatari esclusi dal gruppo di annunci il cui gruppo di annunci padre è in pausa.

withCondition("AdGroupStatus = PAUSED")
AudienceId long ID del gruppo di destinatari associato.

withCondition("AudienceId = 123456789")
CampaignName stringa Nome della campagna che contiene il gruppo di annunci dell'associazione.

withCondition("CampaignName CONTAINS_IGNORE_CASE 'truck'")
CampaignStatus Enumerazione Stato della campagna che contiene il gruppo di annunci dell'associazione. I possibili valori con distinzione tra maiuscole e minuscole sono:
  • ABILITATO
  • PAUSA
  • RIMOSSO
Questo esempio restituisce solo i gruppi di destinatari esclusi dal gruppo di annunci la cui campagna padre è in pausa.

withCondition("CampaignStatus = PAUSED")
Stato Enumerazione Stato dell'associazione. I possibili valori con distinzione tra maiuscole e minuscole sono:
  • ABILITATO
  • PAUSA
  • RIMOSSO
Questo esempio restituisce solo gruppi di destinatari esclusi dal gruppo di annunci abilitato.

withCondition("Status = ENABLED")
UserListName stringa Nome del gruppo di destinatari associato.

withCondition("UserListName = 'foo'")

Argomenti

Nome Tipo Descrizione
Condizione stringa Condizione da applicare al selettore.

Restituisce

Tipo Descrizione
AdGroupExcludedAudienceSelector Selettore con la condizione applicata.

withIds(string[] ids)

Ottiene i gruppi di destinatari esclusi dal gruppo di annunci con gli ID specificati.

È possibile 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 è true E la condizione B è true. Ad esempio, la chiamata seguente seleziona solo il gruppo di annunci escluso 33333.

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

Argomenti

Nome Tipo Descrizione
Id string[] Matrice di ID destinatari esclusi dal gruppo di annunci. Per i limiti, vedere Limiti di esecuzione dello script.

Restituisce

Tipo Descrizione
AdGroupExcludedAudienceSelector Selettore con gli ID applicati.

withLimit(int limit)

Ottiene i primi n gruppi di destinatari esclusi dal gruppo di annunci che corrispondono ai criteri di selezione.

Argomenti

Nome Tipo Descrizione
Limite int Numero di destinatari esclusi dal gruppo di annunci da restituire. Il numero effettivo può essere minore.

Restituisce

Tipo Descrizione
AdGroupExcludedAudienceSelector Selettore con limite applicato.
  • Last updated on