AdGroupSelector
Contiene i metodi per filtrare e ordinare un elenco di gruppi di annunci. Per informazioni sui selettori, vedere Selettori.
Utilizzo di esempio:
var iterator = AdsApp.adGroups()
.withCondition("ClickConversionRate > 0.3")
.forDateRange("LAST_WEEK")
.orderBy("Clicks DESC")
.get();
while (iterator.hasNext()) {
var adGroup = iterator.next();
var metrics = adGroup.getStats();
}
Metodi
Nome metodo | Tipo restituito | Descrizione |
---|---|---|
forDateRange(Object dateFrom, Object dateTo) | AdGroupSelector | Applica le date di inizio e fine per la selezione delle metriche delle prestazioni. |
forDateRange(string dateRange) | AdGroupSelector | Applica l'intervallo di date predefinito per la selezione delle metriche delle prestazioni. |
Ottieni | AdGroupIterator | Ottiene un iteratore usato per scorrere l'elenco dei gruppi di annunci. |
orderBy(string orderBy) | AdGroupSelector | Applica l'ordinamento specificato ai gruppi di annunci selezionati. |
withCondition(string condition) | AdGroupSelector | Applica i criteri di filtro ai gruppi di annunci. |
withIds(string[] ids) | AdGroupSelector | Ottiene gruppi di annunci con gli ID specificati. |
withLimit(int limit) | AdGroupSelector | Ottiene i primi n gruppi di annunci che corrispondono ai criteri di selezione. |
forDateRange(Object dateFrom, Object dateTo)
Applica le date di inizio e fine per la selezione delle metriche delle prestazioni.
Specificare un intervallo di date solo se:
- Si applicano condizioni o si ordinano i campi delle metriche delle prestazioni di riferimento.
- Si vogliono ottenere i dati sulle prestazioni per gli oggetti da selezionare. Ad esempio, se si prevede di chiamare il
getStats()
metodo .
È possibile specificare i parametri di data usando stringhe o oggetti . Per utilizzare le stringhe, specificare la data nel formato AAAAMMGG. Se si usano oggetti , creare un oggetto con i campi seguenti:
- Anno
- Mese
- Giorno
Ad esempio:
var date = {year: 2018, month: 5, day: 13};
Il mese è in base uno, 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 |
---|---|
AdGroupSelector | Selettore con intervallo di date applicato. |
forDateRange(String dateRange)
Applica l'intervallo di date predefinito per la selezione delle metriche delle prestazioni.
Specificare un intervallo di date solo se:
- Si applicano condizioni o si ordinano i campi delle metriche delle prestazioni di riferimento.
- Si vogliono ottenere i dati sulle prestazioni per gli oggetti da selezionare. 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 supportati:
- 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 di intervallo di date predefinita che specifica i dati sulle prestazioni da includere nel selettore. La stringa di intervallo di date predefinita fa distinzione tra maiuscole e minuscole. |
Restituisce
Tipo | Descrizione |
---|---|
AdGroupSelector | Selettore con intervallo di date applicato. |
Ottieni
Ottiene un iteratore usato per scorrere l'elenco dei gruppi di annunci.
Restituisce
Tipo | Descrizione |
---|---|
AdGroupIterator | Iteratore usato per scorrere i gruppi di annunci selezionati. |
orderBy(String orderBy)
Applica l'ordinamento specificato ai gruppi di annunci selezionati.
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 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 |
---|---|
AdGroupSelector | Selettore con ordinamento applicato. |
withCondition(String condition)
Applica i criteri di filtro ai gruppi di annunci.
Specificare il parametro condition nel formato "columnName operator value" dove:
- columnName è una delle colonne supportate. Se columName è impostato su un nome di colonna della metrica delle prestazioni, è necessario specificare un intervallo di date usando forDateRange(String dateRange) o forDateRange(Object dateFrom, Object dateTo).
- 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 annunci. I nomi fanno 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 del conto. |
Ctr | Doppia | withCondition("Ctr > 0.05") Il CTR è compreso nell'intervallo 0..1, quindi usare 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 |
---|---|---|
Stato | Enumerazione | Stato del gruppo di annunci. I possibili valori con distinzione tra maiuscole e minuscole sono:
withCondition("Status = ENABLED") |
Nome | stringa | Nome del gruppo di annunci.withCondition("Name CONTAINS_IGNORE_CASE 'sport'") |
CampaignName | stringa | Il nome della campagna.withCondition("CampaignName CONTAINS_IGNORE_CASE 'truck'") |
KeywordMaxCpc | Doppia | Offerta CPC del gruppo di annunci. L'offerta è nella valuta del conto.withCondition("KeywordMaxCpc > 5.0") |
CampaignStatus | Enumerazione | Stato della campagna. I possibili valori con distinzione tra maiuscole e minuscole sono:
withCondition("CampaignStatus = PAUSED") |
LabelNames | set di stringhe | Elenco di uno o più nomi di etichette con distinzione tra maiuscole e minuscole. Usare per ottenere i gruppi di annunci associati alle etichette denominate.withCondition("LabelNames CONTAINS_ANY ['bar', 'foo']") |
CampaignType | Enumerazione | Tipo della campagna. I possibili valori con distinzione tra maiuscole e minuscole sono:
withCondition("CampaignType = SHOPPING") |
Argomenti
Nome | Tipo | Descrizione |
---|---|---|
Condizione | stringa | Condizione da applicare al selettore. |
Restituisce
Tipo | Descrizione |
---|---|
AdGroupSelector | Selettore con la condizione applicata. |
withIds(string[] ids)
Ottiene gruppi 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 33333.
var selector = AdsApp.adGroups()
.withIds(['11111', '22222', '33333'])
.withIds(['33333', '44444', '55555']);
Argomenti
Nome | Tipo | Descrizione |
---|---|---|
Id | string[] | Matrice di ID gruppo di annunci. Per i limiti, vedere Limiti di esecuzione dello script. |
Restituisce
Tipo | Descrizione |
---|---|
AdGroupSelector | Selettore con gli ID applicati. |
withLimit(int limit)
Ottiene i primi n gruppi di annunci che corrispondono ai criteri di selezione.
Argomenti
Nome | Tipo | Descrizione |
---|---|---|
Limite | int | Numero di gruppi di annunci da restituire. Il numero effettivo può essere minore. |
Restituisce
Tipo | Descrizione |
---|---|
AdGroupSelector | Selettore con limite applicato. |