---
title: "Use filtros de array para gatilhos de eventos"
slug: "using-array-filters-for-event-triggers"
updated: 2026-06-12T10:30:57Z
published: 2026-06-12T10:30:57Z
canonical: "docs.xtremepush.com/using-array-filters-for-event-triggers"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xtremepush.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Use filtros de array para gatilhos de eventos

Refinar o direcionamento da sua campanha aplicando filtros específicos aos gatilhos de eventos que contenham dados de arrays.

Ao configurar um gatilho de campanha na aba **Triggers** , você pode aplicar condições específicas se o evento que você está especificando incluir um array. Isso permite que você segmente usuários com base no conteúdo específico dessa propriedade do array.

## Matrizes de Filtros de Objetos

> [!TIP]
> Você precisa ter o ClickHouse para eventos ativado para usar filtragem de array de objetos. Entre em contato com o suporte para possibilitar isso.

Quando o array no seu gatilho de campanha contém objetos, você pode usar os operadores **Contém Objeto** e **Não Contém Objetos** para filtrar o gatilho da campanha.

Você pode combinar um ou mais critérios para definir o objeto que está procurando. Cada critério é especificado por um:

- **Nome da propriedade**, um operador e um **valor correspondente da propriedade**. Por exemplo, *Sport***É Igual***ao Tênis*
- **Nome da propriedade** e condição booleana. Por exemplo, *is_cashed_out***é igual***a falso*

### Exemplo de cenário: Contém o objeto

Você quer iniciar uma campanha para usuários que fizeram uma aposta em uma partida de tênis com odds maiores que 5. A campanha é desencadeada por um evento *de aposta* , que é registrado toda vez que um usuário faz uma aposta. A seguir está um exemplo dos dados que este evento contém:

```json
{
  "event_name": "bet",
  "timestamp": "2025-09-04T09:21:18Z",
  "properties": {
    "bet_id": "BET-98765",
    "stake": 10.00,
    "parts": [
      {
        "sport": "Football",
        "market": "Match Winner",
        "selection": "Dublin Dynamos",
        "odds": 2.5
      },
      {
        "sport": "Tennis",
        "market": "Player to Win",
        "selection": "A. Player",
        "odds": 6.0 
      }
    ]
  }
}
```

A imagem abaixo mostra como filtrar o gatilho do evento para direcionar usuários que fizeram uma aposta em uma partida de tênis com odds maiores que 5. O gatilho é definido para um evento *de aposta,* e sua propriedade *de partes* deve conter um objeto onde esporte é igual *a Tênis* e as odds são maiores que *5*.

![Example of](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/b16a64d197a8e82cb604869a6fff0de65b70332a95e5426db256976d2f7be723-Screenshot_2025-09-03_at_11.42.35(1).png?sv=2026-02-06&spr=https&st=2026-11-04T09%3A29%3A02Z&se=2026-11-04T10%3A29%3A02Z&sr=c&sp=r&sig=yEFbbZeLBgucicpP7poG2NwtR79mHVWVw91%2B%2F%2FzUU0A%3D)

Exemplo de definir um filtro Contains Object

### Exemplo de cenário: Não Contém Objeto

Você deve enviar uma oferta para incentivar usuários que normalmente fazem apostas de baixo valor a aumentarem o valor da aposta. A campanha é desencadeada por um evento *de aposta* , que é registrado toda vez que um usuário faz uma aposta. A seguir está um exemplo dos dados que este evento contém:

```json
{
  "event_name": "bet",
  "timestamp": "2025-09-04T09:29:31Z",
  "properties": {
    "bet_id": "BET-LOW-001",
    "parts": [
      {
        "market": "First Goalscorer",
        "selection": "C. Striker",
        "stake": 10.00
      },
      {
        "market": "Correct Score",
        "selection": "2-1",
        "stake": 5.00
      }
    ]
  }
}
```

A imagem abaixo mostra como filtrar o gatilho do evento para usuários que normalmente fazem apostas de baixo valor. Sua condição de gatilho está definida para o evento *de aposta* . Essa condição filtra usuários que fazem apostas menores, garantindo que o array *de partes* não contenha nenhum objeto com propriedade de *aposta* maior que *20*.

![Example of ...](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/3b46f74bba3102e34db857eaaa9888d34448863eecb15a2bcac79eb3061bf161-Screenshot_2025-09-03_at_12.03.58(1).png?sv=2026-02-06&spr=https&st=2026-11-04T09%3A29%3A02Z&se=2026-11-04T10%3A29%3A02Z&sr=c&sp=r&sig=yEFbbZeLBgucicpP7poG2NwtR79mHVWVw91%2B%2F%2FzUU0A%3D)

Exemplo de definir um filtro Not Contains Object

## Matrizes de Filtros de Valores Simples

Use os seguintes operadores quando sua propriedade de evento for um simples array de cadeias ou números:

- **Contém Valor** / **Não Contém Valor**: Verifica se existe (ou não existe) um único valor específico no array. Por exemplo, você pode configurar uma campanha para ser acionada se a propriedade do evento *tiver a tag***Contains Value***VIP*.
- **Contém Qualquer Um** De/ **Não Contém Nenhum De:** Verifica se algum (ou nenhum) dos valores de uma lista que você forneceu está presente no array. Por exemplo, você pode configurar uma campanha para ser acionada se o valor do *evento purchased_categories***Contém Qualquer Um de** ["Shoes", "Jackets"].