AssetGroupSelector

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

Esempio di utilizzo:

    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 dei gruppi di risorse.
orderBy(stringa orderBy) AssetGroupSelector Applica l'ordinamento specificato ai gruppi di risorse selezionati.
withCondition(condizione stringa) AssetGroupSelector Applica i criteri di filtro ai gruppi di risorse.
withIds(string[] ids) AssetGroupSelector Ottiene gruppi di risorse con gli ID specificati.
withLimit(int limit) AssetGroupSelector Ottiene i primi n gruppi di asset che soddisfano i criteri di selezione.

Ottieni

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

Restituisce

Tipo Descrizione
AssetGroupIterator Un iteratore utilizzato per scorrere i gruppi di risorse selezionati.

orderBy(stringa orderBy)

Applica l'ordinamento specificato ai gruppi di risorse 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 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 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
AssetGroupSelector Selettore con ordinamento applicato.

withCondition(condizione stringa)

Applica i criteri di filtro ai gruppi di risorse.

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 risorse. 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
Stato Enumerazione Stato del gruppo di asset. I valori possibili con distinzione tra maiuscole e minuscole sono:
  • ABILITATO
  • Pausa
  • RIMOSSO
Questo esempio restituisce solo i gruppi di risorse abilitati.

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 doppia Offerta CPC del gruppo di asset. L'offerta è nella valuta dell'account.

withCondition("KeywordMaxCpc > 5.0")
CampaignStatus Enumerazione Stato della campagna. I valori possibili con distinzione tra maiuscole e minuscole sono:
  • ABILITATO
  • Pausa
  • RIMOSSO
In questo esempio vengono restituiti solo i gruppi di asset la cui campagna padre è sospesa.

withCondition("CampaignStatus = PAUSED")
LabelNames set di stringhe Elenco di uno o più nomi di etichette con distinzione tra maiuscole e minuscole. Consente di ottenere gruppi di risorse associati alle etichette denominate.

withCondition("LabelNames CONTAINS_ANY ['bar', 'foo']")
Tipo di campagna Enumerazione Tipo di campagna. I valori possibili con distinzione tra maiuscole e minuscole sono:
  • SEARCH_AND_CONTENT
  • SHOPPING
  • DYNAMIC_SEARCH_ADS
Questo esempio restituisce solo gruppi di asset il cui tipo di campagna padre è Shopping.

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 risorse 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 asset 33333.

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

Argomenti

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

Restituisce

Tipo Descrizione
AssetGroupSelector Selettore con gli ID applicati.

withLimit(int limit)

Ottiene i primi n gruppi di asset che soddisfano i criteri di selezione.

Argomenti

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

Restituisce

Tipo Descrizione
AssetGroupSelector Selettore con limite applicato.

Vedere anche

Campaign.assetGroups()

  • Ultimo aggiornamento: