AssetGroupSelector
Contiene i metodi per filtrare e ordinare un elenco di gruppi di asset. Per informazioni sui selettori, vedere Selettori.
Utilizzo di esempio:
var iterator = Campaign.assetGroups()
.withCondition("ClickConversionRate > 0.3")
.forDateRange("LAST_WEEK")
.orderBy("Clicks DESC")
.get();
while (iterator.hasNext()) {
var assetGroup = iterator.next();
var metrics = assetGroup.getStats();
}
Metodi
Nome metodo | Tipo restituito | Descrizione |
---|---|---|
Ottieni | AssetGroupIterator | Ottiene un iteratore utilizzato per scorrere l'elenco di gruppi di asset. |
orderBy(string orderBy) | AssetGroupSelector | Applica l'ordinamento specificato ai gruppi di asset selezionati. |
withCondition(string condition) | AssetGroupSelector | Applica criteri di filtro ai gruppi di asset. |
withIds(string[] ids) | AssetGroupSelector | Ottiene gruppi di asset con gli ID specificati. |
withLimit(int limit) | AssetGroupSelector | Ottiene i primi n gruppi di asset che corrispondono ai criteri di selezione. |
Ottieni
Ottiene un iteratore utilizzato per scorrere l'elenco di gruppi di asset.
Restituisce
Tipo | Descrizione |
---|---|
AssetGroupIterator | Iteratore usato per scorrere i gruppi di asset selezionati. |
orderBy(String orderBy)
Applica l'ordinamento specificato ai gruppi di asset 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 asset 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 |
---|---|
AssetGroupSelector | Selettore con ordinamento applicato. |
withCondition(String condition)
Applica criteri di filtro ai gruppi di asset.
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 asset. 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 | doppio | withCondition("AbsoluteTopImpressionRate > 0.25") |
AverageCpc | doppio | withCondition("AverageCpc < 2.75") |
AverageCpm | doppio | withCondition("AverageCpm > 0.65") |
ClickConversionRate | doppio | withCondition("ClickConversionRate > 0.25") |
Clic | long | withCondition("Clicks >= 33") |
ConvertedClicks | long | withCondition("ConvertedClicks >= 10") |
Costo | doppio | withCondition("Cost > 3.25") Il costo è nella valuta del conto. |
Ctr | doppio | 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 | doppio | withCondition("TopImpressionRate > 0.25") |
Di seguito sono riportate le proprietà dell'entità che è possibile specificare.
Colonna | Tipo | Esempio |
---|---|---|
Stato | enumerazione | Stato del gruppo di asset. I possibili valori con distinzione tra maiuscole e minuscole sono:
withCondition("Status = ENABLED") |
Nome | stringa | Nome del gruppo di asset.withCondition("Name CONTAINS_IGNORE_CASE 'sport'") |
CampaignName | stringa | Il nome della campagna.withCondition("CampaignName CONTAINS_IGNORE_CASE 'truck'") |
KeywordMaxCpc | doppio | Offerta CPC del gruppo di asset. 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 asset 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 |
---|---|
AssetGroupSelector | Selettore con la condizione applicata. |
withIds(string[] ids)
Ottiene gruppi di asset 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 asset 33333.
var selector = Campaign.assetGroups()
.withIds(['11111', '22222', '33333'])
.withIds(['33333', '44444', '55555']);
Argomenti
Nome | Tipo | Descrizione |
---|---|---|
Id | string[] | Matrice di ID gruppo di asset. Per i limiti, vedere Limiti di esecuzione dello script. |
Restituisce
Tipo | Descrizione |
---|---|
AssetGroupSelector | Selettore con gli ID applicati. |
withLimit(int limit)
Ottiene i primi n gruppi di asset che corrispondono ai criteri di selezione.
Argomenti
Nome | Tipo | Descrizione |
---|---|---|
limite | int | Numero di gruppi di asset da restituire. Il numero effettivo può essere minore. |
Restituisce
Tipo | Descrizione |
---|---|
AssetGroupSelector | Selettore con limite applicato. |