Condividi tramite


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:

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:
  • ABILITATO
  • PAUSA
  • LONTANO
In questo esempio vengono restituiti solo i gruppi di asset 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 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:
  • ABILITATO
  • PAUSA
  • LONTANO
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. 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:
  • SEARCH_AND_CONTENT
  • COMPERE
  • DYNAMIC_SEARCH_ADS
In questo esempio vengono restituiti 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 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.

Vedere anche

Campaign.assetGroups()