Compartilhar via

AssetGroupSelector

  • Artigo

Contém os métodos para filtrar e ordenar uma lista de grupos de recursos. Para obter informações sobre seletores, consulte Seletores.

Utilização de exemplo:

    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();
    }

Métodos

Nome do Método Tipo de Devolução Descrição
Obter AssetGroupIterator Obtém um iterador utilizado para iterar através da lista de grupos de recursos.
orderBy(string orderBy) AssetGroupSelector Aplica a ordenação especificada aos grupos de recursos selecionados.
withCondition(condição de cadeia) AssetGroupSelector Aplica critérios de filtro aos grupos de recursos.
withIds(string[] ids) AssetGroupSelector Obtém grupos de recursos com os IDs especificados.
withLimit(int limit) AssetGroupSelector Obtém os n principais grupos de recursos que correspondem aos critérios de seleção.

Obter

Obtém um iterador utilizado para iterar através da lista de grupos de recursos.

Devoluções

Tipo Descrição
AssetGroupIterator Um iterador utilizado para iterar através dos grupos de recursos selecionados.

orderBy(String orderBy)

Aplica a ordenação especificada aos grupos de recursos selecionados.

Especifique o parâmetro orderBy no formulário "columnName orderDirection" em que:

  • columnName é uma das colunas suportadas.
  • orderDirection é a ordem para ordenar os resultados. Defina como ASC para ordenar os resultados por ordem ascendente ou DESC para ordenar os resultados por ordem descendente. A predefinição é ASC.

Por exemplo, a chamada seguinte devolve grupos de recursos por ordem ascendente por AverageCpc.

selector = selector.orderBy("AverageCpc");

Os seletores suportam a ordenação de entidades apenas por um campo. Não pode ordenar a lista de entidades por campo x e dentro de x por campo y, etc. Se especificar mais do que uma orderBy() chamada numa cadeia ou em chamadas de seletor separadas, os scripts ordenam a lista de entidades utilizando o campo especificado na última orderBy() chamada. 

Argumentos

Name Tipo Descrição
orderBy cadeia A ordenação a aplicar.

Devoluções

Tipo Descrição
AssetGroupSelector Seletor com ordenação aplicada.

withCondition(Condição de cadeia)

Aplica critérios de filtro aos grupos de recursos.

Especifique o parâmetro condition no formulário "columnName operator value" em que:

Operadores

O operador que utilizar depende do tipo da coluna. Os operadores são sensíveis às maiúsculas e minúsculas. Por exemplo, utilize STARTS_WITH em vez de starts_with.

Operadores para colunas que contêm números inteiros e valores longos:

<
<=
>
>=
=
!=

Operadores para colunas que contêm valores duplos:

<
>

Operadores para colunas que contêm valores de cadeia:

=
!=
STARTS_WITH
STARTS_WITH_IGNORE_CASE
CONTAINS
CONTAINS_IGNORE_CASE
DOES_NOT_CONTAIN
DOES_NOT_CONTAIN_IGNORE_CASE

Operadores para colunas que contêm valores de enumeração:

=
!=
IN []
NOT_IN []

Operadores para colunas que contêm uma matriz de cadeias:

CONTAINS_ALL
CONTAINS_ANY
CONTAINS_NONE

Colunas Suportadas

Colunas suportadas para filtragem de grupos de recursos. Os nomes são sensíveis às maiúsculas e minúsculas.

Seguem-se as colunas de métricas de desempenho que pode especificar.

Coluna Tipo Exemplos:
AbsoluteTopImpressionRate duplo withCondition("AbsoluteTopImpressionRate > 0.25")
AverageCpc duplo withCondition("AverageCpc < 2.75")
AverageCpm duplo withCondition("AverageCpm > 0.65")
ClickConversionRate duplo withCondition("ClickConversionRate > 0.25")
Cliques Longo withCondition("Clicks >= 33")
ConvertClicks Longo withCondition("ConvertedClicks >= 10")
Custo duplo withCondition("Cost > 3.25")

O custo está na moeda da conta.
Ctr duplo withCondition("Ctr > 0.05")

O CTR está no intervalo 0..1, por isso, utilize 0,05 para um CTR de 5%.
Impressões Longo withCondition("Impressions > 10")
TopImpressionRate duplo withCondition("TopImpressionRate > 0.25")

Seguem-se as propriedades da entidade que pode especificar.

Coluna Tipo Exemplos:
Estado enumeração O estado do grupo de ativos. Os possíveis valores sensíveis às maiúsculas e minúsculas são:
  • ATIVADO
  • EM PAUSA
  • REMOVIDO
Este exemplo devolve apenas grupos de recursos ativados.

withCondition("Status = ENABLED")
Name cadeia O nome do grupo de ativos.

withCondition("Name CONTAINS_IGNORE_CASE 'sport'")
CampaignName cadeia O nome da campanha.

withCondition("CampaignName CONTAINS_IGNORE_CASE 'truck'")
Palavra-chaveMaxCpc duplo A oferta CPC do grupo de activos. A oferta está na moeda da conta.

withCondition("KeywordMaxCpc > 5.0")
CampaignStatus enumeração O estado da campanha. Os possíveis valores sensíveis às maiúsculas e minúsculas são:
  • ATIVADO
  • EM PAUSA
  • REMOVIDO
Este exemplo devolve apenas grupos de recursos cuja campanha principal está em pausa.

withCondition("CampaignStatus = PAUSED")
Nomes de Etiqueta conjunto de cadeias Uma lista de um ou mais nomes de etiquetas sensíveis às maiúsculas e minúsculas. Utilize para obter grupos de recursos associados às etiquetas nomeadas.

withCondition("LabelNames CONTAINS_ANY ['bar', 'foo']")
CampaignType enumeração O tipo da campanha. Os possíveis valores sensíveis às maiúsculas e minúsculas são:
  • SEARCH_AND_CONTENT
  • COMPRAS
  • DYNAMIC_SEARCH_ADS
Este exemplo devolve apenas grupos de ativos cujo tipo de campanha principal é Compras.

withCondition("CampaignType = SHOPPING")

Argumentos

Name Tipo Descrição
condição cadeia A condição a aplicar ao seletor.

Devoluções

Tipo Descrição
AssetGroupSelector Seletor com a condição aplicada.

withIds(string[] ids)

Obtém grupos de recursos com os IDs especificados.

Pode aplicar uma ou mais condições a um seletor. Uma cadeia de condições é considerada uma operação E. Por exemplo, a entidade só é selecionada se a condição A for verdadeira E a condição B for verdadeira. Por exemplo, a chamada seguinte seleciona apenas o grupo de recursos 33333.

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

Argumentos

Name Tipo Descrição
IDs cadeia[] Uma matriz de IDs de grupo de ativos. Para obter limites, veja Limites de execução de scripts.

Devoluções

Tipo Descrição
AssetGroupSelector Seletor com os IDs aplicados.

withLimit(int limit)

Obtém os n principais grupos de recursos que correspondem aos critérios de seleção.

Argumentos

Name Tipo Descrição
limite int O número de grupos de ativos a devolver. O número real pode ser menor.

Devoluções

Tipo Descrição
AssetGroupSelector Seletor com limite aplicado.

Consulte também

Campaign.assetGroups()