Enviar dados de perfil

Os desenvolvedores podem configurar duas maneiras nas quais os clientes podem enviar atributos de perfil de comprador para o Einstein: upload em massa e rastreamento de atividades em tempo real. Você pode usar qualquer um dos métodos, ou ambos, para enviar dados de perfil de comprador para o Einstein.

Ao enviar dados para o Einstein, lembre-se do seguinte:

A Salesforce recomenda que você não envie outra informação de identidade pessoal (PII, Personal Identifiable Information) para o Einstein além dos identificadores de usuário recomendados e especificados.
Todos os dados coletados são armazenados por um ano. Depois de 1 ano, os dados expiram e são removidos de todos os bancos de dados do Einstein. Para continuar usando esses dados de perfil, eles devem ser enviados novamente ao Einstein.
Quando o Einstein recebe valores mais novos para atributos de perfil de comprador existentes, esses valores são vinculados aos valores atuais.
O Einstein usa todos os dados de perfil fornecidos. Os novos dados não são mais importantes do que os já existentes.

Upload em massa

A Salesforce oferece um endpoint seguro para o upload em massa para que os clientes façam o upload de dados históricos de perfil de comprador que foram coletados.

A opção de upload em massa serve para:

Quaisquer dados relacionados a perfis de compradores que tenham sido rastreados e coletados.
Quaisquer dados de terceiros confiáveis que você quer que o Einstein use para maior personalização do comprador.

Autorização

O upload de dados em massa causa um impacto importante nos dados do Einstein. Por isso, somente permitimos que usuários autorizados façam o upload de grandes quantidades de dados. Além disso, cada chamada de API para upload deve transmitir um token de acesso de cabeçalho (portador) de autorização necessário obtido do Account Manager.

Observação: Para reduzir a carga no servidor do Account Manager, evite gerar novos tokens até que o token atual expire. Consulte a especificação da API para mais informações sobre as chamadas de API para upload em massa.

Preparação dos dados para upload em massa

Para preparar os dados para upload em massa para uso pelo Einstein, garanta o seguinte:

O arquivo em massa é um arquivo compactado com gzip de valores separados por tabulação (TSV).
O arquivo TSV é formatado e salvo usando codificação de caracteres UTF-8.
O mimetype do arquivo é definido corretamente para uso pelo aplicativo gzip.
A linha de cabeçalho deve conter os campos de identificação login_id ou email_address, ou ambos.
Você pode adicionar colunas extras para cada atributo de perfil de comprador que você quer enviar.
Os valores são strings ou listas de strings. Para uma lista de strings, certifique-se de separar os valores usando o separador de barra vertical (|). Por exemplo, orange|yellow.
As colunas vazias são ignoradas. Quando o Einstein encontra uma coluna vazia, ele ignora essa coluna e continua processando os dados restantes de atributos do usuário.

Upload em massa: identificadores de usuários

Para ajudar a gerar recomendações de produtos relevantes para cada comprador, a Profile Connector API precisa de qualquer um desses identificadores de usuário para a identificação de compradores no upload em massa.

Campo	Descrição
login_id	ID de login do comprador. Em alguns casos, é o mesmo que o valor email_address.
email_address	Endereço completo de e-mail do comprador. Por exemplo, shopper1@somewhere.com.

Exemplo de dados para upload em massa

Veja aqui um exemplo de dados TSV para o upload em massa de perfis de comprador com nomes de colunas aleatórios:

login_id	email_address	gênero	cores	brand_list
shopper1	shopper1@somewhere.com	masculino	laranja\|amarelo	brandA\|brandB
shopper2	shopper2@somewhere.com	feminino	azul\|preto	brandD
shopper3	shopper3@somewhere.com	feminino	vermelho\|preto\|violeta	brandB\|brandE

Limitações do endpoint para o upload em massa de perfis de compradores

Ao realizar o upload em massa de perfis de compradores, considere essas limitações do endpoint:

Só é possível fazer o upload de um arquivo de cada vez. No entanto, você pode fazer o upload de diversos arquivos, um depois do outro.
O tamanho máximo de arquivo permitido é 2 GB.

Upload em massa de dados de perfis de compradores para o Einstein

Depois de preparar os arquivos de dados para upload em massa de perfis de compradores, compacte com gzip cada arquivo e faça o upload no endpoint do Einstein para upload em massa de perfis de compradores. Para obter mais informações, consulte Enviar o endpoint de perfil em massa.

Rastreamento de atividades em tempo real

Use o endpoint de rastreamento de atividades (updateProfile) para chamar e enviar em tempo real atualizações e preferências de dados de perfis de compradores. Coletar informações que um comprador fornece, em tempo real e em sua loja (virtual), permite que as recomendações reflitam essas mudanças de maneira imediata.

A opção de rastreamento de atividades em tempo real serve para:

Coletar atividades de preferência do comprador em tempo real.
Fazer atualizações do perfil de comprador em tempo real.

Para ajudar a gerar recomendações de produtos relevantes para cada comprador, a Profile Connector API fornece dois identificadores de usuário para a identificação de compradores no rastreamento em tempo real.

cookieId (necessário): identificador único de um comprador anônimo. Geralmente, o cookieId é o valor de um cookie próprio.
- Ao fazer solicitações de API de uma loja (virtual) tradicional do Commerce Cloud, transmita o valor cqcid do cookie para corresponder ao rastreamento automático de atividades na loja (virtual) tradicional. Para obter mais informações, consulte Armazenamento local de dados baseado no navegador.
- Ao usar OCAPI ou a Salesforce Commerce API, use o valor visit_id da resposta de login de convidado para corresponder às atividades automáticas. Para obter mais informações, consulte a Documentação do cliente OCAPI.
userId (uso incentivado): identificador único de um comprador conectado. Esse parâmetro permite que o Einstein vincule o mesmo usuário conectado a diferentes dispositivos.
- Ao fazer solicitações de API de uma loja (virtual) tradicional do Commerce Cloud, use o valor cquid do cookie para corresponder ao rastreamento automático de atividades na loja (virtual) tradicional. Para obter mais informações, consulte Armazenamento local de dados baseado no navegador.
- Ao usar OCAPI ou a Salesforce Commerce API, use o valor hashed_login da resposta de login registrado para corresponder às atividades automáticas. Para obter mais informações, consulte a Documentação do cliente OCAPI.

Para evitar atividades potencialmente maliciosas, os parâmetros de identificador do usuário não devem ser sequenciais. Eles não devem incluir sequências, padrões, endereços IP, endereços de e-mail, nomes nem nada vinculado a uma determinada pessoa. Todos os parâmetros de identificador do usuário devem atender à General Data Protection Regulation (GDPR, Norma geral de proteção de dados) através de hash ou outros métodos.

Note