Detalhes da definição de mapeamento do tipo de objeto

A definição do mapeamento do tipo de objeto tem duas partes: a definição do campo e a definição da chave.

dica

Para saber como criar um mapeador de tipos de objetos, consulte esta postagem no blog: Unify and organize customer information with Amazon Connect Customer Profiles with the pre-built Amazon S3 connector. Ou confira este vídeo sobre YouTube: Como integrar os dados do perfil do cliente às suas experiências de contact center.

Detalhes da definição de campo

A definição do campo define a origem, o destino (destino) e o tipo de campo. Por exemplo: .

"Fields": {
        "{fieldName}": {
            "Source": "{source}",
            "Target": "{target}",
            "ContentType": "{contentType}"
        }, ...
    }, ... 

• Source: pode ser um acessador JSON para o campo ou uma macro Handlebar para gerar o valor do campo.

  O objeto de origem que está sendo analisado tem um nome _source, para que todos os campos nos campos de origem precisem ser precedidos por essa string. Somente o objeto _source é compatível.

  Use a solução de macro Handlebar para gerar constantes e combinar vários campos de objetos de origem em um único campo. Isso é útil para indexação.

• Target: especifica onde, em um tipo de objeto padrão, os dados desse campo devem ser mapeados.

  Preencher o perfil padrão permite que você use dados ingeridos de qualquer fonte de dados com aplicações criadas com base nos perfis de clientes sem nenhum conhecimento específico do formato dos dados que estão sendo ingeridos.

  Esse campo é opcional. Talvez você queira definir campos somente com a finalidade de incluí-los em uma chave.

  O formato desse campo é sempre um acessador JSON. O único objeto alvo compatível é _profile.

• ContentType: os valores a seguir são compatíveis STRING, NUMBER, PHONE_NUMBER, EMAIL_ADDRESS, NAME. Se nenhum ContentType for especificado, STRING será assumido.

  ContentType é usado para determinar como indexar o valor para que os atendentes possam pesquisá-lo. Por exemplo, se ContentType estiver definido como PHONE_NUMBER, um número de telefone será processado para que os atendentes possam procurá-lo em qualquer formato: a string “[phone]" corresponde a “(555) -123-4567".

Detalhes de definição da chave

Uma chave contém um ou mais campos que, juntos, definem uma chave que pode ser usada para pesquisar objetos (ou os perfis aos quais eles pertencem) usando a SearchProfilesAPI. A chave também pode ser definida para identificar de forma exclusiva um perfil ou identificar com exclusividade o próprio objeto.

"Keys": {
        "{keyName}": [{
            "StandardIdentifiers": [...],
            "FieldNames": [ "{fieldname}", ...]
        }], ...
    }, ...

Os nomes das chaves são globais para um domínio. Se você tiver duas chaves, com o mesmo nome em dois mapeamentos de tipos de objetos diferentes:

• Essas chaves devem ocupar o mesmo namespace

• Elas podem ser usadas para potencialmente vincular perfis entre objetos diferentes. Se elas corresponderem entre os objetos, o Customer Profiles colocará os dois objetos no mesmo perfil.

Para expressar isso de outra forma: as chaves deverão ter o mesmo nome de chave em um domínio se, e somente se, o mesmo valor indicar que elas estão relacionadas. Por exemplo, um número de telefone especificado em um tipo de objeto estaria relacionado ao mesmo número de telefone especificado em outro tipo de objeto. Um identificador interno especificado para um objeto importado do Salesforce pode não estar relacionado a outro objeto importado do Marketo, mesmo que tenha exatamente o mesmo valor.

As definições de chaves são usadas de duas maneiras:

• Dentro do Customer Profiles durante a ingestão, elas são usadas para descobrir a qual perfil o objeto deve ser atribuído.

• Eles permitem que você use a SearchProfilesAPI para pesquisar o valor da chave e encontrar o perfil.

Teclas de pesquisa padrão

As chaves de pesquisa padrão, como _phone e_email, são predefinidas pelo modelo de objeto Perfil Padrão, Ativo Padrão, Ordem Padrão e Caso Padrão. Você pode usar as chaves de pesquisa padrão como um nome de chave com a SearchProfiles API para encontrar um perfil.