CampaignExcludedAudienceSelector

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

Esempio di utilizzo:

    // Gets the iterator that iterates all campaigns
    // in the account.
    var shoppingCampaign = AdsApp.shoppingCampaigns().withIds(["123456789"]).get();

    // Loops through all campaigns in the account.
    while (iterator.hasNext()) {
        var campaign = iterator.next();

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

Metodi

Nome metodo Tipo restituito Descrizione
Ottieni CampaignExcludedAudienceIterator Ottiene un iteratore usato per scorrere l'elenco dei gruppi di destinatari esclusi dalla campagna.
orderBy(stringa orderBy) CampaignExcludedAudienceSelector Applica l'ordinamento specificato ai gruppi di destinatari esclusi della campagna selezionata.
withCondition(condizione stringa) CampaignExcludedAudienceSelector Applica i criteri di filtro ai gruppi di destinatari esclusi dalla campagna.
withIds(string[] ids) CampaignExcludedAudienceSelector Ottiene i gruppi di destinatari esclusi dalla campagna con gli ID specificati.
withLimit(int limit) CampaignExcludedAudienceSelector Ottiene i primi n gruppi di destinatari esclusi dalla campagna che soddisfano i criteri di selezione.

Ottieni

Ottiene un iteratore usato per scorrere l'elenco dei gruppi di destinatari esclusi dalla campagna.

Restituisce

Tipo Descrizione
CampaignExcludedAudienceIterator Un iteratore usato per eseguire l'iterazione nella campagna selezionata escludeva i gruppi di destinatari.

orderBy(stringa orderBy)

Applica l'ordinamento specificato ai gruppi di destinatari esclusi della campagna selezionata.

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

  • columnName è una delle colonne supportate.
  • 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 gruppi di destinatari esclusi dalla campagna in ordine crescente di AverageCpc.

selector = selector.orderBy("AverageCpc");

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
CampaignExcludedAudienceSelector Selettore con ordinamento applicato.

withCondition(condizione stringa)

Applica i criteri di filtro ai gruppi di destinatari esclusi dalla campagna.

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

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

Colonne supportate per il filtro dei gruppi di destinatari esclusi dalla campagna. Nei nomi viene fatta distinzione tra maiuscole e minuscole.

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

Colonna Tipo Esempio
AudienceId long ID del gruppo di destinatari associato.

withCondition("AudienceId = 123456789")
CampaignName stringa Il nome della campagna dell'associazione.

withCondition("CampaignName CONTAINS_IGNORE_CASE 'truck'")
CampaignStatus Enumerazione Lo stato della campagna dell'associazione. I valori possibili con distinzione tra maiuscole e minuscole sono:
  • ABILITATO
  • Pausa
  • RIMOSSO
Questo esempio restituisce solo i gruppi di destinatari esclusi dalla campagna la cui campagna padre è sospesa.

withCondition("CampaignStatus = PAUSED")
Stato Enumerazione Lo stato dell'associazione. I valori possibili con distinzione tra maiuscole e minuscole sono:
  • ABILITATO
  • Pausa
  • RIMOSSO
Questo esempio restituisce solo i gruppi di destinatari esclusi dalla campagna abilitati.

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
CampaignExcludedAudienceSelector Selettore con la condizione applicata.

withIds(string[] ids)

Ottiene i gruppi di destinatari esclusi dalla campagna 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 il gruppo di destinatari escluso dalla campagna 33333.

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

Argomenti

Nome Tipo Descrizione
ID stringa[] Matrice di ID gruppo di destinatari esclusi dalla campagna. Per i limiti, vedere Limiti di esecuzione degli script.

Restituisce

Tipo Descrizione
CampaignExcludedAudienceSelector Selettore con gli ID applicati.

withLimit(int limit)

Ottiene i primi n gruppi di destinatari esclusi dalla campagna che soddisfano i criteri di selezione.

Argomenti

Nome Tipo Descrizione
Limite int Il numero di gruppi di destinatari esclusi dalla campagna da restituire. Il numero effettivo potrebbe essere inferiore.

Restituisce

Tipo Descrizione
CampaignExcludedAudienceSelector Selettore con limite applicato.
  • Ultimo aggiornamento: