ProductGroupSelector
Contém os métodos para filtrar e ordenar uma lista de grupos de produtos. Para obter informações sobre seletores, consulte Seletores.
Utilização de exemplo:
var iterator = AdsApp.productGroups()
.withCondition("ClickConversionRate > 0.3")
.forDateRange("LAST_WEEK")
.orderBy("Clicks DESC")
.get();
while (iterator.hasNext()) {
var productGroup = iterator.next();
var metrics = productGroup.getStats();
}
Métodos
| Nome do Método | Tipo de Devolução | Descrição |
|---|---|---|
| forDateRange(Data do objetoA partir de, Data do objetoTo) | ProductGroupSelector | Aplica as datas de início e de fim para selecionar métricas de desempenho. |
| forDateRange(string dateRange) | ProductGroupSelector | Aplica o intervalo de datas predefinido para selecionar métricas de desempenho. |
| obter | AdGroupIterator | Obtém um iterador utilizado para iterar através da lista de grupos de produtos. |
| orderBy(string orderBy) | ProductGroupSelector | Aplica a ordenação especificada aos grupos de produtos selecionados. |
| withCondition(condição de cadeia) | ProductGroupSelector | Aplica critérios de filtro aos grupos de produtos. |
| withIds(string[] ids) | ProductGroupSelector | Obtém grupos de produtos com os IDs especificados. |
| withLimit(int limit) | ProductGroupSelector | Obtém os n principais grupos de produtos que correspondem aos critérios de seleção. |
forDateRange(Data do objetoA partir de, Data do objetoTo)
Aplica as datas de início e de fim para selecionar métricas de desempenho.
Especifique um intervalo de datas apenas se:
- Aplica condições ou ordenação que referenciam campos de métricas de desempenho.
- Quer obter dados de desempenho para os objetos que está a selecionar. Por exemplo, se planear chamar o
getStats()método .
Pode especificar os parâmetros de data com cadeias ou objetos. Para utilizar cadeias, especifique a data no formulário YYYYMMDD. Se utilizar objetos, crie um objeto com os seguintes campos:
- ano
- mês
- dia
Por exemplo:
var date = {year: 2018, month: 5, day: 13};
O mês é baseado num, em que 1 é janeiro e 12 é dezembro.
O intervalo de datas é inclusivo. Se especificar vários intervalos de datas, só é utilizado o último intervalo de datas.
Argumentos
| Name | Tipo | Descrição |
|---|---|---|
| dateFrom | Objeto | A data de início do intervalo de datas que especifica os dados de desempenho a incluir no seletor. |
| dateTo | Objeto | A data de fim do intervalo de datas que especifica os dados de desempenho a incluir no seletor. |
Devoluções
| Tipo | Descrição |
|---|---|
| ProductGroupSelector | Seletor com intervalo de datas aplicado. |
forDateRange(String dateRange)
Aplica o intervalo de datas predefinido para selecionar métricas de desempenho.
Especifique um intervalo de datas apenas se:
- Aplica condições ou ordenação que referenciam campos de métricas de desempenho.
- Quer obter dados de desempenho para os objetos que está a selecionar. Por exemplo, se planear chamar o
getStats()método .
Se especificar vários intervalos de datas, só é utilizado o último intervalo de datas.
Valores de intervalo de datas suportados:
- HOJE
- ONTEM
- LAST_WEEK
- LAST_BUSINESS_WEEK
- LAST_7_DAYS
- THIS_WEEK_SUN_TODAY
- LAST_14_DAYS
- LAST_30_DAYS
- LAST_WEEK_SUN_SAT
- THIS_MONTH
- LAST_MONTH
- ALL_TIME
Argumentos
| Name | Tipo | Descrição |
|---|---|---|
| dateRange | Cadeia | A cadeia de intervalo de datas predefinida que especifica os dados de desempenho a incluir no seletor. A cadeia de intervalo de datas predefinida é sensível às maiúsculas e minúsculas. |
Devoluções
| Tipo | Descrição |
|---|---|
| ProductGroupSelector | Seletor com intervalo de datas aplicado. |
obter
Obtém um iterador utilizado para iterar através da lista de grupos de produtos.
Devoluções
| Tipo | Descrição |
|---|---|
| AdGroupIterator | Um iterador utilizado para iterar através dos grupos de produtos selecionados. |
orderBy(String orderBy)
Aplica a ordenação especificada aos grupos de produtos 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 produtos 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 |
|---|---|
| ProductGroupSelector | Seletor com ordenação aplicada. |
withCondition(Condição de cadeia)
Aplica critérios de filtro aos grupos de produtos.
Especifique o parâmetro condition no formulário "columnName operator value" em que:
- columnName é uma das Colunas suportadas. Se columName estiver definido como um nome de coluna de métrica de desempenho, tem de especificar um intervalo de datas com forDateRange(String dateRange) ou forDateRange(Object dateFrom, Object dateTo).
- O operador é um dos operadores suportados.
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 produtos. 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 | long | withCondition("Clicks >= 33") |
| ConvertClicks | long | 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 | long | withCondition("Impressions > 10") |
| TopImpressionRate | duplo | withCondition("TopImpressionRate > 0.25") |
Seguem-se as propriedades da entidade que pode especificar.
| Coluna | Tipo | Exemplos: |
|---|---|---|
| Grupo de Produtos | cadeia | O valor do grupo de produtos. Por exemplo, se o caminho for "Todos os produtos > Sporting Goods > Winter Sports > Skis >> Downhill Skis > New", poderá definir o operando como Skis.withCondition("ProductGroup = Skis")O seletor inclui o grupo de produtos Skis e o grupo de produtos "outros casos", se existir. Tenha em atenção que não pode especificar "OtherCase" como operando. |
| Licitação | duplo | O montante da oferta. Devolve todos os grupos de produtos que correspondem à condição de licitação.withCondition("Bid < 2.75")A utilização de "<" devolve grupos com um valor de licitação CPC inferior ao valor especificado ou definido como nulo. Para impedir o seletor de incluir o caso nulo, utilize, por exemplo, .withCondition("Bid < 2.75").withCondition("Bid > 0.0"). |
Argumentos
| Name | Tipo | Descrição |
|---|---|---|
| condição | cadeia | A condição a aplicar ao seletor. |
Devoluções
| Tipo | Descrição |
|---|---|
| ProductGroupSelector | Seletor com a condição aplicada. |
withIds(string[] ids)
Obtém grupos de produtos 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 produtos 33333.
var selector = AdsApp.productGroups()
.withIds(['11111', '22222', '33333'])
.withIds(['33333', '44444', '55555']);
Argumentos
| Name | Tipo | Descrição |
|---|---|---|
| IDs | cadeia[] | Uma matriz de IDs de grupo de produtos. Para obter limites, veja Limites de execução de scripts. |
Devoluções
| Tipo | Descrição |
|---|---|
| ProductGroupSelector | Seletor com os IDs aplicados. |
withLimit(int limit)
Obtém os n principais grupos de produtos que correspondem aos critérios de seleção.
Argumentos
| Name | Tipo | Descrição |
|---|---|---|
| limite | int | O número de grupos de produtos a devolver. O número real pode ser menor. |
Devoluções
| Tipo | Descrição |
|---|---|
| ProductGroupSelector | Seletor com limite aplicado. |