Objeto de público conectado

Um objeto de público conectado identifica o público de sua mensagem. Por exemplo, se você usar matrizes de atributos personalizados para rastrear todas as categorias e programas de TV que um usuário favoritou, poderá usar públicos conectados para enviar automaticamente uma notificação por push ou um e-mail para qualquer pessoa que tenha favoritado um programa sempre que um novo episódio for lançado, sem a necessidade de configurar um segmento para cada programa.

Esse objeto é composto de um único filtro de público conectado ou de vários filtros de público conectados em uma expressão lógica usando os operadores AND ou OR.

Exemplo de filtro múltiplo:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
  "AND":
    [
      Connected Audience Filter,
      {
        "OR" :
          [
            Connected Audience Filter,
            Connected Audience Filter
          ]
      },
      Connected Audience Filter
    ]
}

Filtros de público conectados

A combinação de vários filtros de atributos personalizados com os operadores AND e OR cria um filtro de público conectado.

Filtro de atributo personalizado

Esse filtro permite segmentar com base em um atributo personalizado do usuário. Esses filtros contêm até três campos:

1
2
3
4
5
6
7
8
{
  "custom_attribute":
    {
      "custom_attribute_name": (String) the name of the custom attribute to filter on,
      "comparison": (String) one of the allowed comparisons to make against the provided value,
      "value": (String, Numeric, Boolean) the value to be compared using the provided comparison
    }
}

Comparações permitidas por tipo de dados

O tipo de dados do atributo personalizado determina as comparações que são válidas para um determinado filtro.

Advertências sobre a comparação de atribuições

Exemplo de atributo personalizado

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
{
  "custom_attribute":
    {
      "custom_attribute_name": "eye_color",
      "comparison": "equals",
      "value": "blue"
    }
}

{
  "custom_attribute":
  {
    "custom_attribute_name": "favorite_foods",
    "comparison": "includes_value",
    "value": "pizza"
  }
}

{
  "custom_attribute":
  {
    "custom_attribute_name": "last_purchase_time",
    "comparison": "less_than_x_days_ago",
    "value": 2
  }
}

Filtro de inscrição push

Esse filtro permite segmentar com base no status da inscrição push de um usuário.

Corpo do filtro

1
2
3
4
5
6
7
{
  "push_subscription_status":
  {
    "comparison": (String) one of the following allowed comparisons,
    "value": (String) one of the following allowed values
  }
}

• Comparações permitidas: is, is_not
• Valores permitidos: opted_in, subscribed, unsubscribed

Filtro de inscrição de e-mail

Esse filtro permite segmentar com base no status de inscrição de e-mail de um usuário.

Corpo do filtro

1
2
3
4
5
6
7
{
  "email_subscription_status":
  {
    "comparison": (String) one of the following allowed comparisons,
    "value": (String) one of the following allowed values
  }
}

• Comparações permitidas: is, is_not
• Valores permitidos: opted_in, subscribed, unsubscribed

Último filtro de app usado

Esse filtro permite segmentar com base em quando o usuário usou o app pela última vez. Esses filtros contêm dois campos:

Corpo do filtro

1
2
3
4
5
6
7
{
  "last_used_app":
  {
    "comparison": (String) one of the allowed comparisons listed,
    "value": (String) the value to be compared using the provided comparison
  }
}

• Comparações permitidas: after, before
• Valores permitidos: datetime (string ISO 8601)

Considerações

Os públicos conectados não podem filtrar usuários por atributos padrão, eventos personalizados, segmentos ou eventos de engajamento com mensagens. Para usar esses filtros, recomendamos incorporá-los em um segmento de público e, em seguida, especificar esse segmento no parâmetro segment_id para o ponto de extremidade/messages/send . Ao usar outros endpoints, você precisará adicionar o segmento à campanha disparada pela API ou ao Canva no dashboard do Braze primeiro.