Dettagli della definizione della mappatura dei tipi di oggetto

La definizione di mappatura dei tipi di oggetto è composta da due parti: la definizione del campo e la definizione della chiave.

Suggerimento

Per informazioni su come creare un mappatore di tipi di oggetti, consulta questo post di blog: Unifica e organizza le informazioni sui clienti con Profili cliente Amazon Connect con il connettore Amazon S3 preinstallato. Oppure, guarda questo video su YouTube: Come integrare i dati del profilo del cliente nelle esperienze dei contact center.

Dettagli sulla definizione del campo

La definizione del campo definisce l'origine, la destinazione (target) e il tipo di campo. Per esempio:

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

• Source: può trattarsi di una funzione di accesso JSON per il campo o di una macro Handlebar per la generazione del valore del campo.

  L'oggetto di origine che viene analizzato è chiamato _source quindi tutti i campi nei campi di origine devono essere preceduti da questa stringa. Solo l'oggetto _source è supportato.

  Utilizza la soluzione macro Handlebar per generare costanti e combinare più campi dell'oggetto di origine in un unico campo. Ciò è utile per l'indicizzazione.

• Target: specifica dove, in un tipo di oggetto standard, devono essere mappati i dati di questo campo.

  La compilazione del profilo standard consente di utilizzare i dati importati da qualsiasi origine dati con applicazioni basate su Profili cliente senza alcuna conoscenza specifica del formato dei dati importati.

  Questo campo è facoltativo. Potresti voler definire i campi esclusivamente allo scopo di includerli in una chiave.

  Il formato di questo campo è sempre un accessor JSON. L'unico oggetto di destinazione supportato è _profile.

• ContentType: sono supportati i seguenti valori STRING, NUMBER, PHONE_NUMBER, EMAIL_ADDRESS, NAME. Se non viene specificato nessun valore ContentType, viene assunto STRING.

  ContentType viene utilizzato per determinare come indicizzare il valore in modo che gli agenti possano cercarlo. Ad esempio, se ContentType è impostato su PHONE_NUMBER, un numero di telefono viene elaborato in modo che gli agenti possano cercarlo in qualsiasi formato: la stringa "[phone]" corrisponde a "(555)-123-4567".

Dettagli chiave della definizione

Una chiave contiene uno o più campi che insieme definiscono una chiave che può essere utilizzata per cercare oggetti (o i profili a cui appartengono) utilizzando l'SearchProfilesAPI. La chiave può anche essere definita per identificare in modo univoco un profilo o identificare in modo univoco l'oggetto stesso.

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

I nomi delle chiavi sono globali per un dominio. Se hai due chiavi con lo stesso nome in due diverse mappature dei tipi di oggetto:

• Queste chiavi devono occupare lo stesso spazio dei nomi

• Sono utilizzabili per collegare potenzialmente i profili per oggetti diversi. Se corrispondono per gli oggetti, Profili cliente posiziona i due oggetti nello stesso profilo.

Per dirla in un altro modo: le chiavi devono avere lo stesso nome della chiave in un dominio se, e solo se, lo stesso valore significa che sono correlate. Ad esempio, un numero di telefono specificato in un tipo di oggetto sarebbe correlato allo stesso numero di telefono specificato in un altro tipo di oggetto. Un identificatore interno specificato per un oggetto importato da Salesforce potrebbe non essere correlato a un altro oggetto importato da Marketo, anche se ha esattamente lo stesso valore.

Le definizioni delle chiavi vengono utilizzate in due modi:

• All'interno di Profili cliente durante l'inserimento, vengono utilizzati per determinare a quale profilo è necessario assegnare l'oggetto.

• Consentono di utilizzare l'SearchProfilesAPI per cercare il valore della chiave e trovare il profilo.

Chiavi di ricerca predefinite

Le chiavi di ricerca predefinite, come _phone e_email, sono predefinite dai modelli di oggetti Standard Profile, Standard Asset, Standard Order e Standard Case. È possibile utilizzare le chiavi di ricerca predefinite come nome chiave con l'SearchProfiles API per trovare un profilo.