Explicação sobre campos personalizados para o Advocate

Você pode usar campos personalizados para enviar ao impact.com dados adicionais sobre os participantes do seu programa de indicação. Essas informações podem ser usadas nas suas regras do programa para determinar quando metas e ações são acionadas. Você também pode segmentar seus participantes com base nos valores dos campos personalizados.

Os tipos de campos personalizados que você envia são flexíveis. Por exemplo, talvez você queira incluir informações sobre:

• Data de nascimento
• Idioma
• Localização
• Tipo de assinatura
• Status de associação

Os campos personalizados podem ser enviados ao impact.com quando você carregar um arquivo de importação de usuários ou via UTT, API, SDK ou outro método de integração.

Características do campo

Quaisquer campos personalizados que você enviar precisam atender a alguns requisitos para nomes e valores de campos.

Nomes

• Até 64 caracteres.
• Apenas caracteres alfanuméricos, hífens e sublinhados são aceitos (as letras devem ser sem acento).
• Diferencia maiúsculas de minúsculas, por exemplo, customFieldName é tratado como diferente de customfieldname.

Valores

• Suporta string, número, Booleano, e tipos nulos.
• Valor máximo de string de 1024 caracteres.
• As datas devem ser formatadas como um timestamp Unix em milissegundos.
• É possível adicionar/atualizar no máximo 100 campos por solicitação.
• Definir um campo personalizado de um usuário como nulo removerá o campo para esse usuário.

Enviar informações de campos personalizados para o impact.com

Você pode incluir campos personalizados sempre que criar, atualizar ou fazer upsert de usuários, independentemente do método pelo qual você envia os dados.

Importações de arquivos

Você pode incluir campos personalizados ao importar novos usuários ou atualizar usuários existentes em massa. Consulte Importar participantes do Advocate em massa para obter instruções.

Abaixo estão dois arquivos de exemplo que você pode usar para orientar sua importação.

• Importações de dados de usuários: CSV ou JSONL
• Importações de dados de eventos: CSV ou JSONL

APIs e SDKs

Campos personalizados podem ser incluídos ao usar os métodos GraphQL ou endpoints da API REST que criam, atualizam ou fazem upsert de usuários. Eles também podem ser incluídos ao usar UTT ou nossas opções móveis para criar, atualizar ou fazer upsert de usuários diretamente do seu aplicativo.