ProductGroupSelector

Contiene i metodi per filtrare e ordinare un elenco di gruppi di prodotti. Per informazioni sui selettori, vedere Selettori.

Esempio di utilizzo:

    var iterator = AdsApp.productGroups()
        .withCondition("ClickConversionRate > 0.3")
        .forDateRange("LAST_WEEK")
        .orderBy("Clicks DESC")
        .get();

    while (iterator.hasNext()) {
        var productGroup = iterator.next();
        var metrics = productGroup.getStats();
    }

Metodi

Nome metodo	Tipo restituito	Descrizione
forDateRange(Oggetto dateFrom, Oggetto dateTo)	ProductGroupSelector	Applica le date di inizio e di fine per la selezione delle metriche del rendimento.
forDateRange(stringa dateRange)	ProductGroupSelector	Applica l'intervallo di date predefinito per la selezione delle metriche del rendimento.
Ottieni	ProductGroupIterator	Ottiene un iteratore utilizzato per scorrere l'elenco dei gruppi di prodotti.
orderBy(stringa orderBy)	ProductGroupSelector	Applica l'ordinamento specificato ai gruppi di prodotti selezionati.
withCondition(condizione stringa)	ProductGroupSelector	Applica i criteri di filtro ai gruppi di prodotti.
withIds(string[] ids)	ProductGroupSelector	Ottiene i gruppi di prodotti con gli ID specificati.
withLimit(int limit)	ProductGroupSelector	Consente di ottenere i primi n gruppi di prodotti che soddisfano i criteri di selezione.

forDateRange(Oggetto dateFrom, Oggetto dateTo)

Applica le date di inizio e di fine per la selezione delle metriche del rendimento.

Specificare un intervallo di date solo se:

Applichi condizioni o ordini che fanno riferimento ai campi delle metriche delle prestazioni.
Si desidera ottenere dati sulle prestazioni per gli oggetti selezionati. Ad esempio, se si prevede di chiamare il getStats() metodo.

È possibile specificare i parametri di data usando stringhe o oggetti. Per usare le stringhe, specificare la data nel formato AAAAMMGG. Se si utilizzano oggetti, creare un oggetto con i campi seguenti:

anno
mese
giorno

Ad esempio:

var date = {year: 2018, month: 5, day: 13};

Il mese è a base unica, dove 1 è gennaio e 12 è dicembre.

L'intervallo di date è inclusivo. Se si specificano più intervalli di date, viene usato solo l'ultimo intervallo di date.

Argomenti

Nome	Tipo	Descrizione
dateFrom	Oggetto	Data di inizio dell'intervallo di date che specifica i dati sulle prestazioni da includere nel selettore.
dateTo	Oggetto	Data di fine dell'intervallo di date che specifica i dati sulle prestazioni da includere nel selettore.

Restituisce

Tipo	Descrizione
ProductGroupSelector	Selettore con intervallo di date applicato.

forDateRange(String dateRange)

Applica l'intervallo di date predefinito per la selezione delle metriche del rendimento.

Specificare un intervallo di date solo se:

Applichi condizioni o ordini che fanno riferimento ai campi delle metriche delle prestazioni.
Si desidera ottenere dati sulle prestazioni per gli oggetti selezionati. Ad esempio, se si prevede di chiamare il getStats() metodo.

Se si specificano più intervalli di date, viene usato solo l'ultimo intervallo di date.

Valori dell'intervallo di date supportato:

OGGI
IERI
LAST_WEEK
LAST_BUSINESS_WEEK
LAST_7_DAYS
THIS_WEEK_SUN_TODAY
LAST_14_DAYS
LAST_30_DAYS
LAST_WEEK_SUN_SAT
THIS_MONTH
LAST_MONTH
ALL_TIME

Argomenti

Nome	Tipo	Descrizione
dateRange	Stringa	Stringa dell'intervallo di date predefinito che specifica i dati sul rendimento da includere nel selettore. Per la stringa dell'intervallo di date predefinita viene fatta distinzione tra maiuscole e minuscole.

Restituisce

Tipo	Descrizione
ProductGroupSelector	Selettore con intervallo di date applicato.

Ottieni

Ottiene un iteratore utilizzato per scorrere l'elenco dei gruppi di prodotti.

Restituisce

Tipo	Descrizione
ProductGroupIterator	Un iteratore utilizzato per eseguire l'iterazione tra i gruppi di prodotti selezionati.

orderBy(stringa orderBy)

Applica l'ordinamento specificato ai gruppi di prodotti selezionati.

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

withCondition(condizione stringa)

Applica i criteri di filtro ai gruppi di prodotti.

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

columnName è una delle colonne supportate. Se columName è impostato su un nome di colonna di metrica sul rendimento, è necessario specificare un intervallo di date utilizzando forDateRange(String dateRange) o forDateRange(Object dateFrom, Object dateTo).
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

Colonne supportate per il filtro dei gruppi di prodotti. Nei nomi viene fatta distinzione tra maiuscole e minuscole.

Di seguito sono riportate le colonne delle metriche delle prestazioni che è possibile specificare.

Colonna	Tipo	Esempio
AbsoluteTopImpressionRate	doppia	`withCondition("AbsoluteTopImpressionRate > 0.25")`
AverageCpc	doppia	`withCondition("AverageCpc < 2.75")`
AverageCpm	doppia	`withCondition("AverageCpm > 0.65")`
ClickConversionRate	doppia	`withCondition("ClickConversionRate > 0.25")`
Clic	long	`withCondition("Clicks >= 33")`
ConvertedClicks	long	`withCondition("ConvertedClicks >= 10")`
Costo	doppia	`withCondition("Cost > 3.25")` Il costo è nella valuta dell'account.
CTR	doppia	`withCondition("Ctr > 0.05")` Il CTR è nell'intervallo 0..1, quindi usa 0.05 per un CTR del 5%.
Impression	long	`withCondition("Impressions > 10")`
TopImpressionRate	doppia	`withCondition("TopImpressionRate > 0.25")`

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

Colonna	Tipo	Esempio
Gruppo di prodotti	stringa	Valore del gruppo di prodotti. Ad esempio, se il percorso è "Tutti i prodotti > Articoli sportivi Sport > invernali > Sci > da sci > Sci da discesa > Nuovi", è possibile impostare l'operando su Sci. `withCondition("ProductGroup = Skis")` Il selettore include il gruppo di prodotti Skis e il suo gruppo di prodotti "other case", se esistente. Si noti che non è possibile specificare 'OtherCase' come operando.
Offerta	doppia	Importo dell'offerta. Restituisce tutti i gruppi di prodotti che soddisfano la condizione di offerta. `withCondition("Bid < 2.75")` L'utilizzo di "<" restituisce i gruppi con un importo di offerta CPC inferiore all'importo specificato o impostato su Null. Per evitare che il selettore includa le maiuscole e minuscole null, usare ad esempio `.withCondition("Bid < 2.75").withCondition("Bid > 0.0")`.

Argomenti

Nome	Tipo	Descrizione
condizione	stringa	Condizione da applicare al selettore.

Restituisce

Tipo	Descrizione
ProductGroupSelector	Selettore con la condizione applicata.

withIds(string[] ids)

Ottiene i gruppi di prodotti 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. La chiamata seguente, ad esempio, seleziona solo il gruppo di prodotti 33333.

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

Argomenti

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

Restituisce

Tipo	Descrizione
ProductGroupSelector	Selettore con gli ID applicati.

withLimit(int limit)

Consente di ottenere i primi n gruppi di prodotti che soddisfano i criteri di selezione.

Argomenti

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

Restituisce

Tipo	Descrizione
ProductGroupSelector	Selettore con limite applicato.

Vedere anche

AdsApp.productGroups()AdGroup.productGroups()

Commenti e suggerimenti

Questa pagina è stata utile?

Ultimo aggiornamento: 2026-09-11

ProductGroupSelector

Metodi

forDateRange(Oggetto dateFrom, Oggetto dateTo)

Argomenti

Restituisce

forDateRange(String dateRange)

Argomenti

Restituisce

Ottieni

Restituisce

orderBy(stringa orderBy)

Argomenti

Restituisce

withCondition(condizione stringa)

Operatori

Colonne supportate

Argomenti

Restituisce

withIds(string[] ids)

Argomenti

Restituisce

withLimit(int limit)

Argomenti

Restituisce

Vedere anche

Commenti e suggerimenti

Risorse aggiuntive