Objeto do público conectado

Um objeto de público conectado é um seletor que identifica o público para o qual enviar a mensagem.

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 criará um filtro de público conectado, que criará um filtro de público conectado quando combinado com os operadores AND e OR.

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 foi a última vez que o usuário usou o app. 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 filtro segment_id.