Identificar usuários

Use esse ponto de extremidade para identificar um usuário não identificado (somente alias, somente e-mail ou somente número de telefone) usando a ID externa fornecida.

Como funciona?

A chamada para /users/identify combina um perfil de usuário que é identificado por um alias (perfil somente de alias), endereço de e-mail (perfil somente de e-mail) ou número de telefone (perfil somente de número de telefone) com um perfil de usuário que tem um external_id (perfil identificado) e, em seguida, remove o perfil somente de alias.

A identificação de um usuário requer que um external_id seja incluído nos seguintes objetos:

• aliases_to_identify
• emails_to_identify
• phone_numbers_to_identify

Se não houver um usuário com esse external_id, o external_id será adicionado ao registro do usuário aliasing, e o usuário será considerado identificado. Os usuários só podem ter um alias para um rótulo específico. Se um usuário já existir com o external_id e tiver um alias existente com o mesmo rótulo do perfil somente de alias, os perfis de usuário não serão combinados.

Comportamento de mesclagem

Por padrão, esse ponto de extremidade mesclará a seguinte lista de campos encontrados exclusivamente no usuário anônimo para o usuário identificado.

Pré-requisitos

Para usar esse endpoint, você precisará de uma chave de API com a permissão users.identify.

Limite de taxa

Aplicamos um limite de frequência compartilhada de 20.000 solicitações por minuto a esse endpoint. Esse limite de frequência é compartilhado com os endpoints /users/delete, /users/alias/new, /users/merge e /users/alias/update, conforme documentado em Limites de frequência da API.

Corpo da solicitação

1
2
Content-Type: application/json
Authorization: Bearer YOUR_REST_API_KEY

1
2
3
4
5
{
   "aliases_to_identify" : (required, array of alias to identify objects),
   "emails_to_identify": (optional, array of alias to identify objects) User emails to identify,
   "phone_numbers_to_identify": (optional, array of alias to identify objects) User phone numbers to identify,
},

Parâmetros de solicitação

É possível adicionar até 50 aliases de usuário por solicitação. É possível associar vários aliases de usuário adicionais a um único external_id.

Identificação de usuários por endereços de e-mail e números de telefone

Se um endereço de e-mail ou número de telefone for especificado como um identificador, você também deverá incluir prioritization no identificador.

O prioritization deve ser uma matriz que especifica qual usuário deve ser mesclado se houver vários usuários encontrados. prioritization é uma matriz ordenada, ou seja, se mais de um usuário corresponder a uma priorização, a mesclagem não ocorrerá.

Os valores permitidos para a matriz são:

• identified
• unidentified
• most_recently_updated (refere-se à priorização do usuário atualizado mais recentemente)
• least_recently_updated (refere-se à priorização do usuário atualizado menos recentemente)

Somente uma das opções a seguir pode existir na matriz de priorização por vez:

• identified refere-se à priorização de um usuário com uma external_id
• unidentified refere-se à priorização de um usuário sem um external_id

Se você especificar identified na matriz, isso significaria que o usuário deve ter um external_id para ser inserido no Canva. Se quiser que os usuários com endereços de e-mail digitem a mensagem, independentemente de estarem identificados ou não, use apenas o parâmetro most_recently_updated ou least_recently_updated.

Exemplo de solicitação

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
curl --location --request POST 'https://rest.iad-01.braze.com/users/identify' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_REST_API_KEY' \
--data-raw '{
  "aliases_to_identify": [
    {
      "external_id": "external_identifier",
      "user_alias": {
          "alias_name": "example_alias",
          "alias_label": "example_label"
      }
    }
  ],
  "emails_to_identify": [
    {
      "external_id": "external_identifier_2",
      "email": "[email protected]",
      "prioritization": ["unidentified", "most_recently_updated"]
    }
  ]
}'

Resposta

1
2
3
4
5
6
Content-Type: application/json
Authorization: Bearer YOUR_REST_API_KEY
{
    "aliases_processed": 1,
    "message": "success"
}