É possível usar tipos mais avançados de campos de filtro nas regras baseadas em horários.
Você pode definir tipos específicos de prefixos para filtros de insights. Isso é semelhante aos prefixos definidos em filtros de metadados usados para realizar uma filtragem multinível.
Você pode definir um prefixo de nível de objeto em um filtro para aproveitar a filtragem multinível de insights. Por exemplo, uma regra de anúncios pode ser filtrada por conjunto de anúncios ou desempenho da campanha. Você também pode especificar os prefixos de janela de atribuição e predefinição de tempo em um filtro. Isso é usado para substituir a janela de atribuição e a predefinição de tempo da regra nesse filtro específico.
Os prefixos são opcionais. Um campo pode ter:
Você pode ter todas as opções acima, nenhuma ou qualquer combinação, desde que as mantenha nessa ordem. O campo deve ter o seguinte formato:
{ object_level_prefix?
} {attribution_window_prefix?
} { time_preset_prefix?
} { field_name
}
Abaixo, veja exemplos corretos e incorretos de campos de insights prefixados. Também mostramos exemplos corretos e incorretos de campos de metadados prefixados para você saber quais filtros são aceitos.
spent
adset.yesterday_spent
: valor total gasto no nível do conjunto de anúncios referente ao dia anterior.
adset.spent
: valor total gasto no nível do conjunto de anúncios.
yesterday_spent
: valor total gasto referente ao dia anterior.
campaign.28d_view_1d_click:lifetime_results
: resultados totais no nível do conjunto de anúncios durante a respectiva vida útil, com janela de atribuição de 28 dias após a visualização e 1 dia após o clique.
campaign.lifetime_spent
: valor total gasto no nível da campanha de anúncios durante a respectiva vida útil.
lifetime_campaign.spent
: os prefixos de predefinição de tempo não podem aparecer antes dos prefixos de nível de objeto.
lifetime_today_spent
: não pode haver dois prefixos de predefinição de tempo.
ad.adset.spent
: não pode haver dois prefixos de nível de objeto.
yesterday.adset_spent
: delimitador incorreto.
daily_budget
adset.daily_budget
: orçamento diário do conjunto de anúncios.
daily_budget
: orçamento diário.
yesterday_daily_budget
: não é possível usar prefixos de predefinição de tempo nos campos de metadados.
ad.daily_budget
: os anúncios não têm um orçamento diário.
Prefixo | Tipo de objeto | Válido para tipos de objetos |
---|---|---|
| Anúncio | Anúncio |
| Conjunto de anúncios | Anúncio, conjunto de anúncios |
| Campanha | Anúncio, conjunto de anúncios, campanha |
Prefixo de janela de atribuição | Descrição |
---|---|
| Use a configuração da janela de atribuição do nível da conta. |
| A janela de atribuição padrão do Facebook é visualizações de 1 dia, cliques de 28 dias. |
| Apenas atribuição inline (visualizações de 0 dia, cliques de 0 dia) |
| Visualizações de 1 dia, cliques de 0 dia |
| Visualizações de 7 dias, cliques de 0 dia |
| Visualizações de 28 dias, cliques de 0 dia |
| Visualizações de 0 dia, cliques de 1 dia |
| Visualizações de 0 dia, cliques de 7 dias |
| Visualizações de 0 dia, cliques de 28 dias |
| Visualizações de 1 dia, cliques de 1 dia |
| Visualizações de 7 dias, cliques de 1 dia |
| Visualizações de 28 dias, cliques de 1 dia |
| Visualizações de 1 dia, cliques de 7 dias |
| Visualizações de 7 dias, cliques de 7 dias |
| Visualizações de 28 dias, cliques de 7 dias |
| Visualizações de 7 dias, cliques de 28 dias |
| Visualizações de 28 dias, cliques de 28 dias |
Esta é a mesma lista de valores válidos de predefinição de tempo, mas em minúsculas e com um delimitador anexado.
Prefixo | Descrição |
---|---|
| Vida útil do objeto |
| O dia atual começa a partir da meia-noite no fuso horário da conta de anúncios |
|
|
| Últimos 2 dias inteiros e |
| Últimos 6 dias inteiros e |
| Últimos 13 dias inteiros e |
| Últimos 27 dias inteiros e |
| Últimos 29 dias inteiros e |
| Este mês, incluindo |
| Esta semana usando a segunda-feira como primeiro dia da semana, incluindo |
| Esta semana usando o domingo como primeiro dia da semana, incluindo |
| O dia inteiro anterior, excluindo |
| Últimos 2 dias inteiros, excluindo |
| Últimos 3 dias inteiros, excluindo |
| Últimos 7 dias inteiros, excluindo |
| Últimos 14 dias inteiros, excluindo |
| Últimos 28 dias inteiros, excluindo |
| Últimos 30 dias inteiros, excluindo |
| Últimos 14 dias até os últimos 7 dias para retorno sobre o investimento em publicidade (ROAS) |
| Últimos 30 dias até os últimos 7 dias para retorno sobre o investimento em publicidade (ROAS) |
| Últimos 60 dias até os últimos 7 dias para retorno sobre o investimento em publicidade (ROAS) |
| Últimos 120 dias até aos últimos 7 dias para retorno sobre o investimento em publicidade (ROAS) |
| Últimos 180 dias até os últimos 7 dias para retorno sobre o investimento em publicidade (ROAS) |
| Vida útil até os últimos 7 dias para retorno sobre o investimento em publicidade (ROAS) |
| Últimos 60 dias até os últimos 28 dias para retorno sobre o investimento em publicidade (ROAS) |
| Últimos 120 dias até os últimos 28 dias para retorno sobre o investimento em publicidade (ROAS) |
| Últimos 180 dias até os últimos 28 dias para retorno sobre o investimento em publicidade (ROAS) |
| Vida útil até os últimos 28 dias para retorno sobre o investimento em publicidade (ROAS) |
Você pode agregar alguns campos de insights em vários objetos de anúncio. Isso permite criar filtros nas métricas de um subconjunto específico de objetos de anúncio. Por exemplo, o alcance total de vários anúncios ou o número total de cliques em diferentes conjuntos de anúncios.
Enquanto algumas métricas (como clicks
) são calculadas com uma soma simples, outras (como reach
) são calculadas de forma diferente. Uma vez que reach
é baseado em impressões únicas, os usuários duplicados são removidos da agregação em vários objetos de anúncio.
Um campo agregado tem este formato: aggregate(
{ field
})
. O field
pode conter os prefixos de janela de atribuição e de predefinição de tempo. O conjunto de objetos de anúncio a serem agregados é determinado por outro campo de filtro obrigatório aggregation_id
.
aggregate(reach)
aggregate(lifetime_reach)
aggregate(daily_budget)
aggregate(adset.reach)
O filtro aggregation_id
especifica quais objetos de anúncio devem ser agregados. Ele só aceita o operador IN
e uma lista de identificações como valor. As identificações podem ser de anúncios, conjuntos de anúncios ou campanhas, mas todas devem ser do mesmo nível de objeto.
aggregation_id
{ "field": "aggregation_id", "operator": "IN", "value": [1234, 5678] }, { "field": "aggregate(reach)", "operator": "GREATER_THAN", "value": 100 }
clicks
cpc
cpm
cpp
ctr
frequency
impressions
mobile_app_purchase_roas
reach
result_rate
spent
unique_clicks
unique_impressions
website_purchase_roas
cost_per_unique_click
Você pode definir expressões aritméticas simples como um campo. Por exemplo, é possível usar essa opção para encontrar a razão entre dois campos numéricos.
Isso funciona em campos de insights e em um subconjunto de campos numéricos de metadados. Confira a lista completa de valores aceitos abaixo.
Um campo de fórmula consiste em campos ou constantes e operadores sintaticamente corretos separados por espaços. Ele é compatível com os operadores +
-
*
e /
. Você pode adicionar constantes, por exemplo, para pesar campos específicos ou fazer compensações.
Neste caso, os campos podem ser totalmente prefixados para que você possa adicionar prefixos válidos de nível de objeto e predefinição de tempo.
No momento, permitimos o uso de até 6
campos não constantes em uma fórmula. Você pode ter quantas constantes quiser.
today_spent / adset.today_spent
0.8 * cpc + 0.2 * cpm
{ field_or_constant_1
} { +
| -
| *
| /
} { field_or_constant_2
}
today_spent / adset.daily_budget
: porcentagem de gastos diários.
clicks / adset.clicks
: razão entre cliques e cliques do conjunto de anúncios.
today_impressions / yesterday_impressions
: razão entre o número de impressões do dia atual e o número de impressões do dia anterior.
today_impressions / aggregate(today_impressions)
: razão entre o número de impressões do dia atual e o número agregado de impressões.
(adset.spent - spent)
: é permitido usar parênteses; as fórmulas recebidas nas respostas da API serão colocadas entre parênteses.
(clicks + cpc + cpm + ctr + cpa + cpp) / cost_per
: não é possível usar mais do que 6
campos.
today_impressions/yesterday_impressions
: os termos devem ser separados por espaço.
Campo | Válido para tipos de objetos |
---|---|
| Anúncio, conjunto de anúncios |
| Conjunto de anúncios |
| Conjunto de anúncios |
| Campanha |