CampaignExcludedAudienceSelector
Contiene i metodi per filtrare e ordinare un elenco di gruppi di destinatari esclusi dalla campagna. Per informazioni sui selettori, vedere Selettori.
Utilizzo di esempio:
// 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 utilizzato per scorrere l'elenco dei gruppi di destinatari esclusi dalla campagna. |
orderBy(string orderBy) | CampaignExcludedAudienceSelector | Applica l'ordinamento specificato ai gruppi di destinatari esclusi della campagna selezionata. |
withCondition(string condition) | CampaignExcludedAudienceSelector | Applica 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 corrispondono ai criteri di selezione. |
Ottieni
Ottiene un iteratore utilizzato per scorrere l'elenco dei gruppi di destinatari esclusi dalla campagna.
Restituisce
Tipo | Descrizione |
---|---|
CampaignExcludedAudienceIterator | Iteratore usato per scorrere i gruppi di destinatari esclusi dalla campagna selezionata. |
orderBy(String orderBy)
Applica l'ordinamento specificato ai gruppi di destinatari esclusi della campagna selezionata.
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 dalla campagna 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 |
---|---|
CampaignExcludedAudienceSelector | Selettore con ordinamento applicato. |
withCondition(String condition)
Applica criteri di filtro ai gruppi di destinatari esclusi dalla campagna.
Specificare il parametro condition nel formato "columnName operator value" dove:
- columnName è una delle colonne supportate.
- operator è uno degli operatori supportati.
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 dalla campagna. I nomi fanno 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 | Nome della campagna dell'associazione.withCondition("CampaignName CONTAINS_IGNORE_CASE 'truck'") |
CampaignStatus | Enumerazione | Stato della campagna dell'associazione. I possibili valori con distinzione tra maiuscole e minuscole sono:
withCondition("CampaignStatus = PAUSED") |
Stato | Enumerazione | Stato dell'associazione. I possibili valori con distinzione tra maiuscole e minuscole sono:
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.
È 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 destinatari esclusi dalla campagna 33333.
var selector = AdsApp.adGroups()
.withIds(['11111', '22222', '33333'])
.withIds(['33333', '44444', '55555']);
Argomenti
Nome | Tipo | Descrizione |
---|---|---|
Id | string[] | Una matrice di ID gruppo di destinatari esclusi dalla campagna. Per i limiti, vedere Limiti di esecuzione dello script. |
Restituisce
Tipo | Descrizione |
---|---|
CampaignExcludedAudienceSelector | Selettore con gli ID applicati. |
withLimit(int limit)
Ottiene i primi n gruppi di destinatari esclusi dalla campagna che corrispondono ai criteri di selezione.
Argomenti
Nome | Tipo | Descrizione |
---|---|---|
Limite | int | Numero di destinatari esclusi dalla campagna da restituire. Il numero effettivo può essere minore. |
Restituisce
Tipo | Descrizione |
---|---|
CampaignExcludedAudienceSelector | Selettore con limite applicato. |
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per