AssetGroupSelector

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

Exemplo de utilização:

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

Metodologia

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

Obter

Obtém um iterador usado para iterar através da lista de grupos de ativos.

Devoluções

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

orderBy(String orderBy)

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

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

  • columnName é uma das colunas suportadas.
  • orderDirection é a ordem pela qual ordenar os resultados. Defina ASC para ordenar os resultados por ordem ascendente ou DESC para ordenar os resultados por ordem descendente. O padrão é ASC.

Por exemplo, a chamada seguinte devolve grupos de ativos por ordem ascendente por CpcMédia.

selector = selector.orderBy("AverageCpc");

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

Argumentos

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

Devoluções

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

withCondition(condição String)

Aplica critérios de filtro aos grupos de ativos.

Especifique o parâmetro de condição no formulário, "columnName operator value" onde:

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 de caracteres:

CONTAINS_ALL
CONTAINS_ANY
CONTAINS_NONE

Colunas Suportadas

Colunas suportadas para filtragem de grupos de ativos. 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")
MédiaCpc duplo withCondition("AverageCpc < 2.75")
MédiaCpm duplo withCondition("AverageCpm > 0.65")
ClickConversionRate duplo withCondition("ClickConversionRate > 0.25")
Cliques longo withCondition("Clicks >= 33")
ConvertedClicks longo withCondition("ConvertedClicks >= 10")
Custo duplo withCondition("Cost > 3.25")

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

A CTR está no intervalo 0..1, então use 0,05 para uma CTR de 5%.
Impressões longo withCondition("Impressions > 10")
TopImpressionRate duplo withCondition("TopImpressionRate > 0.25")

A seguir estão as propriedades da entidade que você pode especificar.

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

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 de CPC do grupo de ativos. O lance é na moeda da conta.

withCondition("KeywordMaxCpc > 5.0")
Estado da Campanha 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 retorna apenas grupos de ativos cuja campanha pai está pausada.

withCondition("CampaignStatus = PAUSED")
LabelNames 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 ativos associados às etiquetas com nome.

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 retorna apenas grupos de ativos cujo tipo de campanha pai é Compras.

withCondition("CampaignType = SHOPPING")

Argumentos

Name Tipo Descrição
Condição cadeia A condição a ser aplicada ao seletor.

Devoluções

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

withIds(string[] ids)

Obtém grupos de ativos com as IDs especificadas.

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 a seguir seleciona apenas o grupo de ativos 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 limites, consulte 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 ativos 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()

  • Last updated on