Criar novo alias de usuário
/users/alias/new
Use este endpoint para adicionar novos aliases de usuário a usuários identificados existentes ou para criar novos usuários não identificados.
Você pode especificar até 50 aliases de usuário por solicitação.
Adicionar um alias de usuário a um usuário existente exige que um external_id seja incluído no novo objeto de alias de usuário. Se o external_id estiver presente no objeto, mas não houver nenhum usuário com esse external_id, o alias não será adicionado a nenhum usuário. Se não houver um external_id, o usuário ainda será criado, mas precisará ser identificado depois. Você pode fazer isso com a “Identificação de usuários” e o endpoint users/identify.
Criar um novo usuário somente de alias exige que o external_id seja omitido do novo objeto de alias de usuário. Depois que o usuário for criado, use o endpoint /users/track para associar o usuário somente de alias a atributos, eventos e compras, e o endpoint /users/identify para identificar o usuário com um external_id.
Você pode enviar Campaigns disparadas por API para usuários por user_alias usando o endpoint /campaigns/trigger/send.
Quando alias_label e alias_name já existem
A combinação de alias_label e alias_name deve ser única em toda a sua base de usuários. Para saber mais, consulte Aliases de usuário.
Se você enviar uma solicitação em que o par alias_label e alias_name já existe para qualquer usuário (seja o mesmo usuário ou outro), o endpoint ainda retornará uma resposta de sucesso (por exemplo, "aliases_processed": 1, "message": "success"). Nesse caso, nenhum novo alias é adicionado ao usuário da solicitação. Como o par alias_label e alias_name já está em uso, a solicitação não faz nenhuma alteração, e pode parecer que o alias nunca foi adicionado ao usuário em questão.
Endpoint reference
This reference is generated from the OpenAPI specification for this endpoint. To run the endpoint, copy the generated cURL example and send it from your terminal or Postman. You can also download the raw OpenAPI spec for this page at /docs/pt-br/assets/api/openapi/users_alias_new.yaml. Use this spec to validate that your requests include the correct parameters, fields, and structure before you send them. To learn how, see Use OpenAPI schemas for request validation.