

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Mappatura del tipo di oggetto in Amazon Connect Customer Profiles
<a name="customer-profiles-object-type-mapping"></a>

La mappatura dei tipi di oggetto indica a Profili dei clienti come importare un tipo specifico di dati. Fornisce a Profili dei clienti informazioni essenziali, come:
+ In che modo i dati devono essere compilati dall'oggetto e inseriti nell'oggetto del profilo standard. 
+ Quali campi devono essere indicizzati nell'oggetto e come tali campi devono quindi essere utilizzati per assegnare oggetti di questo tipo a un profilo specifico.

Gli argomenti di questa sezione forniscono informazioni e passaggi per facilitare la configurazione della mappatura dei tipi di oggetto, tra cui come creare la mappatura dei tipi di oggetto, i dettagli della definizione della mappatura e i concetti e la terminologia chiave. 

**Topics**
+ [

# Concetti e terminologia per la mappatura dei tipi di oggetto dei clienti
](customer-profiles-terminology.md)
+ [Creazione di una mappatura del tipo di oggetto](create-object-type-mapping.md)
+ [

# Dettagli della definizione di mappatura dei tipi di oggetto in Amazon Connect Customer Profiles
](object-type-mapping-definition-details.md)
+ [

# Proprietà aggiuntive dei tipi di oggetti in Profili dei clienti
](additional-properties-object-types.md)
+ [

# Profili dedotti
](inferred-profiles.md)
+ [Modelli di record di contatti](ctr-contact-record-template.md)
+ [

# Associa automaticamente il Record di contatto a un profilo trovato utilizzando il tasto \$1phone in Profili dei clienti
](auto-associate-profile-using-phone-profile-key.md)
+ [

# Esempi di mappature del tipo di oggetto in Amazon Connect Customer Profiles
](examples-object-type-mappings.md)
+ [

# Tipi di oggetto del profilo implicito in Amazon Connect Customer Profiles
](implicit-profile-object-types.md)
+ [Mappatura dei dati basata sull'IA generativa](genai-powered-data-mapping.md)
+ [Limiti di dati per Profili dei clienti](customer-profiles-data-limits.md)

# Concetti e terminologia per la mappatura dei tipi di oggetto dei clienti
<a name="customer-profiles-terminology"></a>

La terminologia e i concetti seguenti sono alla base della comprensione e dell'utilizzo di mappature dei tipi di oggetto personalizzate. 

**Oggetto profilo standard**  <a name="StandardProfileObject"></a>
Un *oggetto di profilo standard* è un oggetto predefinito contenuto in tutti i profili.   
Un oggetto profilo standard contiene campi standard, come numeri di telefono, indirizzi e-mail, nome e altri dati standard. Questi dati possono essere recuperati in un formato standard indipendentemente dalla fonte (ad esempio, Salesforce o Marketo). ServiceNow

**Oggetto profilo**  <a name="ProfileObject"></a>
Un *oggetto profilo* è una singola unità di informazioni nota su un profilo. Ad esempio, le informazioni su una telefonata, un ticket, un caso o persino un record di clickstream proveniente da un sito web.  
Un singolo oggetto di profilo può pesare fino a 250 KB e può essere qualsiasi documento JSON strutturato.   
+ Ogni oggetto del profilo ha un tipo. Ad esempio, l'oggetto profilo può essere un record di contatto Amazon Connect, ServiceNow Users o Marketo Leads. 
+ Il tipo si riferisce alla mappatura del tipo di oggetto.
+ La mappatura dei tipi di oggetto definisce il modo in cui quell'oggetto specifico deve essere importato in Profili cliente.

**Profilo**  <a name="Profile"></a>
Un *profilo* contiene tutte le informazioni note su un cliente o un contatto specifico. Include un singolo oggetto di profilo standard e un numero qualsiasi di oggetti di profilo aggiuntivi.

**La mappatura dei tipi di oggetto**  <a name="ObjectTypeMapping"></a>
La *mappatura dei tipi di oggetto* indica a Profili cliente come importare un tipo specifico di dati. Fornisce a Profili cliente le informazioni seguenti:   
+ In che modo i dati devono essere compilati dall'oggetto e inseriti nell'oggetto del profilo standard. 
+ Quali campi devono essere indicizzati nell'oggetto e come tali campi devono quindi essere utilizzati per assegnare oggetti di questo tipo a un profilo specifico.

**Modello di mappatura**  <a name="MappingTemplate"></a>
Un *modello di mappatura* è una mappatura predefinita del tipo di oggetto inclusa nel servizio Profili cliente.  
I profili dei clienti includono modelli di mappatura per i record di contatti di Amazon Connect, gli account Salesforce, ServiceNow gli utenti e i lead Marketo. Per un elenco completo dei modelli di mappatura disponibili, utilizza l'API. [ListProfileObjectTypeTemplates](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjectTypeTemplates.html)  
Con i modelli di mappatura è possibile importare rapidamente dati da origini note senza dover specificare alcuna informazione aggiuntiva.

# Come creare una mappatura dei tipi di oggetto di Amazon Connect Customer Profiles.
<a name="create-object-type-mapping"></a>

Una mappatura dei tipi di oggetto indica ai profili dei clienti come inserire un tipo specifico di dati da un'applicazione di origine, come Salesforce, Zendesk o S3, in un oggetto di profilo standard unificato. È possibile quindi visualizzare i dati in quell'oggetto (ad esempio, indirizzo del cliente ed e-mail) agli agenti utilizzando l'[applicazione agente Amazon Connect](customer-profile-access.md). 

La mappatura del tipo di oggetto fornisce a Profili cliente le seguenti informazioni: 
+ In che modo i dati devono essere compilati dall'oggetto e inseriti nell'oggetto del profilo standard.
+ Quali campi devono essere indicizzati nell'oggetto e come tali campi devono quindi essere utilizzati per assegnare oggetti di questo tipo a un profilo specifico.

Esistono due modi per creare una mappatura dei tipi di oggetto:
+ Utilizza la console Amazon Connect. L'interfaccia utente rende le funzionalità di mappatura dei dati facilmente accessibili. Ad esempio, è possibile aggiungere attributi personalizzati e definire identificatori di ricerca e univoci per i modelli di contatto. Non è richiesta alcuna codifica\$1 
+ Utilizzo dell'API di Profili cliente Per ulteriori informazioni, consulta la [Documentazione di riferimento delle API di Profili cliente Amazon Connect](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/Welcome.html).

In questo argomento viene descritto come creare una mappatura utilizzando la console Amazon Connect.

## Creazione di una mappatura dei dati utilizzando la console Amazon Connect
<a name="create-object-type-mapping-ui"></a>

Amazon Connect offre un'esperienza senza codice per mappare i dati dei clienti da applicazioni locali e di terze parti con Amazon S3, Salesforce, Zendesk e Marketo. ServiceNow

Per creare una mappatura dei dati, definisci una mappatura del tipo di oggetto che descrive l'aspetto dell'oggetto del profilo personalizzato. Questa mappatura definisce come i campi dei dati possono essere utilizzati per popolare i campi nel profilo standard o come possono essere utilizzati per assegnare i dati a un profilo specifico.

### Passaggio 1: configurazione della mappatura dei dati
<a name="step1-how-to-set-up-data-mapping"></a>

1. Apri la console Amazon Connect all'indirizzo [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/).

1. Nella pagina delle istanze, seleziona l'alias dell'istanza. L'alias dell'istanza è anche il **nome dell'istanza** che appare nell'URL Amazon Connect. L'immagine seguente mostra la pagina **Istanze di contact center virtuali di Amazon Connect**, con un riquadro attorno all'alias dell'istanza.  
![\[La pagina delle istanze del contact center virtuale di Amazon Connect, l'alias dell'istanza.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/instance.png)

1. Nel riquadro di navigazione, scegli **Profili dei clienti**, **Mappature dei dati**.

1. Scegli **Crea mappatura dei dati** per iniziare.

1. Nella pagina **Configura la mappatura dei dati**, nella sezione **Descrizione**, aggiungi un nome che ti aiuti a identificare l'origine o lo scopo di questa mappatura. Questi sono i metadati del tipo di oggetto. 

1. Nella sezione **Origine dati**:

   1. Scegli da dove provengono i dati, ad esempio Salesforce o Zendesk. In base alla selezione, Amazon Connect seleziona automaticamente le destinazioni disponibili in base al modello predefinito. 

   1. Scegliere l'oggetto di origine. Questo viene utilizzato per creare il profilo unificato.

   1. Nella sezione **Mappatura della destinazione**, scegli i dati che desideri utilizzare per creare il profilo cliente unificato. Queste informazioni possono essere fornite ai flussi e agli agenti per personalizzare le interazioni con i contatti.

      Per ulteriori informazioni sulle destinazioni di mappatura supportate, consulta [Informazioni sulle destinazioni di mappatura in Amazon Connect](about-mapping-destinations.md).

   1. Nella sezione **Opzioni aggiuntive**, è possibile scegliere quando rinunciare alla creazione di nuovi profili e per quanto tempo conservarli. Queste opzioni consentono di gestire i costi.
**Nota**  
Il periodo predefinito per la conservazione dei domini è 366 giorni. Per modificare il periodo di conservazione impostato sul tuo dominio, usa l'[UpdateDomain](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_UpdateDomain.html)API. 

1. Se hai scelto una fonte diversa da S3, nella *application* sezione **Stabilisci una connessione con**, scegli una EventBridge connessione Amazon AppFlow o Amazon esistente per connettere i tuoi dati o crea una nuova connessione. È possibile creare una nuova connessione inserendo i dettagli dell'account per questa origine dati.

   Dopo aver stabilito la connessione, scegli gli oggetti che desideri importare dall'origine dati. 

1. Scegli **Next (Successivo)**.

### Passaggio 2: mappatura degli attributi
<a name="step2-how-to-map-attributes"></a>

Nella pagina **Attributi del *tipo* di mappa**, appare la tabella delle mappature dei campi riempita con il modello predefinito, in base alla destinazione della mappatura. Ad esempio, è compilata con gli attributi del cliente, del prodotto, del caso o dell'ordine. Puoi modificare il modello predefinito scegliendo un attributo (ad esempio AccountNumber) e quindi selezionando una destinazione diversa oppure inserendo uno dei tuoi attributi personalizzati. 

L'immagine seguente mostra un esempio della pagina riempita con gli attributi del cliente del modello.

![\[Menu di navigazione di Amazon Connect, pagina Mappa degli attributi del cliente.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-data-mapping-2.png)


È possibile rimuovere ciò che non si desidera venga inserito nel profilo cliente, modificare l'origine e aggiungere attributi personalizzati.

Questa mappatura utilizza l'origine dati per inserire le informazioni di contatto dei clienti, ad esempio il numero di telefono nel profilo del cliente. Utilizza gli attributi del modello di profilo standard.

**Suggerimento**  
Se si sceglie di aggiungere attributi personalizzati, alla destinazione verrà sempre aggiunto il prefisso `Attributes.`. Ciò consente ad Amazon Connect di riconoscere che si tratta di un attributo personalizzato.   

![\[Interfaccia di mappatura degli attributi del cliente che mostra i campi di origine mappati ai campi di destinazione.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/custom-attribute-cp.png)

Gli agenti possono ora visualizzare gli attributi personalizzati nell'applicazione Connect Agent nella scheda **Informazioni aggiuntive** in ordine alfabetico. È possibile creare il nome desiderato per ogni attributo che verrà visualizzato agli agenti utilizzando il seguente formato: `/^Attributes\.[a-zA-Z0-9]+(?:[ _\-]+[a-zA-Z0-9]+)*$/`
Tutti gli attributi personalizzati importati verranno visualizzati nell'applicazione Connect Agent. Se non si desidera mostrare determinate informazioni agli agenti, non importare attributi personalizzati in questo momento.

### Passaggio 3: Specifica degli identificatori
<a name="step3-how-to-specify-identifiers"></a>

Nella pagina **Specifica gli identificatori**, completa le seguenti sezioni. A seconda dei dati che vengono mappati, è possibile che non tutti vengano visualizzati sulla pagina.

**Nota**  
I nomi `_profileId`, `_orderId`, `_caseId` e `_assetId` sono riservati per uso interno. Se decidi di utilizzare questi nomi come uno dei nomi identificativi, devono essere dichiarati come `LOOKUP_ONLY`, il che significa che il nostro sistema non li salverà in modo che corrispondano a profili, risorse standard, ordini standard, casi standard o li salverà per la ricerca nel profilo, risorsa, caso o ordine. Se desideri che queste chiavi siano utilizzabili per la ricerca e la corrispondenza, è necessario rinominare la chiave. Per ulteriori informazioni sull'identificatore `LOOKUP_ONLY` standard, vedi [Identificatori standard per l’impostazione degli attributi sulla chiave in Profili dei clienti](standard-identifiers.md). 
+ **Identificatore univoco**: è necessario disporre di un identificatore univoco per i dati al fine di evitare errori durante l'importazione. Questo identificatore è noto anche come chiave univoca. Profili cliente lo utilizza per distinguere questi dati da altri oggetti di origine dati e per indicizzarli per la ricerca e l'aggiornamento dei dati. 

  Può esserci un solo identificatore univoco.
+ **Identificatore del cliente**: è necessario disporre di almeno un identificatore del cliente per i dati per evitare errori durante l'inserimento. L'identificatore è anche noto come chiave profilo.

  Profili cliente lo utilizza per determinare se il data case è associato a un profilo esistente o utilizzato per creare un nuovo profilo cercando questo identificatore in altri profili.

  È possibile disporre di più identificatori del cliente. 
**Suggerimento**  
Gli agenti possono utilizzare uno qualsiasi di questi identificatori del cliente nel workspace degli agenti per trovare il profilo che appartiene al cliente nell'interazione.
+ **Identificatore del prodotto**: è necessario disporre di almeno un identificatore di prodotto per i dati al fine di evitare errori quando vengono importati. L'identificatore è anche noto come chiave di risorsa.

  Profili cliente lo utilizza per distinguere questi dati dai dati di acquisto dei prodotti di altri clienti. Viene anche utilizzato per determinare se i dati possono essere associati a un profilo esistente o utilizzati per creare un nuovo profilo cercando questo identificatore in altri profili.

  È possibile disporre di più identificatori di prodotto.
+ **Identificatore del caso**: è necessario disporre di almeno un identificatore del caso per i dati per evitare errori durante l'importazione. L'identificatore è anche noto come chiave del caso.

  Profili cliente lo utilizza per distinguere questi dati dagli altri dati relativi ai casi dei clienti. Viene anche utilizzato per determinare se i dati possono essere associati a un profilo esistente o utilizzati per creare un nuovo profilo cercando questo identificatore in altri profili.

  È possibile disporre di più identificatori di casi.
+ **Identificatore dell'ordine**: è necessario disporre di almeno un identificatore dell'ordine per i dati per evitare errori durante l'importazione. L'identificatore è anche noto come chiave dell'ordine.

  Profili cliente lo utilizza per distinguere questi dati dagli altri dati degli ordini dei clienti. Viene anche utilizzato per determinare se i dati possono essere associati a un profilo esistente o utilizzati per creare un nuovo profilo cercando questo identificatore in altri profili.

  È possibile disporre di più identificatori dell'ordine.
+ **Attributi di ricerca aggiuntivi: facoltativi**: è possibile scegliere gli attributi nell'oggetto dell'origine dati che desideri indicizzare per renderli ricercabili. Per impostazione predefinita, tutti gli identificatori sono indicizzati.
**Suggerimento**  
Se gli attributi di ricerca negli oggetti dell’origine dati contengono per lo più lo stesso valore, l’importazione dei dati potrebbe rallentare. È consigliabile creare attributi di ricerca univoci negli oggetti dell’origine dati.
+ **Timestamp dell'oggetto dati**: il timestamp dell'oggetto dati viene utilizzato per risolvere i conflitti tra i profili quando Risoluzione delle identità è abilitata per consolidare profili simili. Quando due o più profili simili hanno record in conflitto, verranno utilizzati i record del profilo con il timestamp aggiornato più di recente.

  È possibile scegliere un attributo dell'oggetto a cui fare riferimento per l'ultima volta che l'oggetto è stato aggiornato.

### Fase 4: Revisione e creazione
<a name="step4-how-to-review"></a>

Dopo aver creato la mappatura dei dati, è possibile scegliere **Aggiungi integrazione dell'origine dati** per utilizzare questo tipo di oggetto. 

![\[Interfaccia di Amazon Connect Customer Profiles che mostra dettagli di mappatura dei dati di esempio e lo stato dell’integrazione.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-data-mapping-3.png)


# Informazioni sulle destinazioni di mappatura in Amazon Connect
<a name="about-mapping-destinations"></a>

Una destinazione di mappatura è la mappatura da un'origine a una definizione standard già definita in Amazon Connect.

La tabella seguente elenca le destinazioni di mappatura supportate.


| Oggetto di origine | Destinazione: Customer, Product, Order, Case | 
| --- | --- | 
|  S3  | Qualsiasi  | 
|  Salesforce-Account  | Cliente  | 
|  Salesforce-Contact  | Cliente  | 
|  Salesforce-Asset  | Product  | 
|  Zendesk-users  | Cliente  | 
|  Marketo-leads  | Cliente  | 
|  Servicenow-sys\$1user  | Cliente  | 
|  Segment-Identify  | Cliente  | 
|  Segment-Customer  | Cliente  | 
|  Shopify-Customer  | Cliente  | 
|  Shopify- DraftOrder  | Order  | 
|  Zendesk-tickets  | Caso  | 
|  Servicenow-task  | Caso  | 
|  Servicenow-incident  | Caso  | 

# Requisiti di mappatura dei tipi di oggetto in Profili dei clienti
<a name="object-type-mapping-requirements"></a>

Affinché Profili cliente possano elaborare i dati in entrata, è necessario che nella mappatura dei tipi di oggetto siano presenti le seguenti informazioni: 
+ Una definizione di tutti i campi dell'oggetto importato che devono essere mappati al profilo standard o utilizzati per assegnare i dati a un profilo. Ciò indica a Profili cliente quali campi dell'oggetto di **origine** importato devono essere mappati a determinati campi nell'oggetto del profilo standard.
+ Quali campi dell'oggetto di origine dei dati personalizzati devono essere indicizzati e in che modo. 

  Quando i dati di origine vengono importati da Profili cliente, i campi indicizzati determinano:
  + A quale profilo appartiene un oggetto specifico.
  + Quali oggetti sono correlati tra loro e devono essere inseriti nello stesso profilo. Ad esempio, un numero di account o un ID di contatto in un record di contatto. 
  + Quali valori possono essere utilizzati per trovare un profilo. Ad esempio, il nome del contatto può essere indicizzato. Ciò consente agli agenti di trovare tutti i profili che appartengono ai clienti con un nome specifico. 

## Requisiti della chiave
<a name="key-requirements"></a>

È necessario definire almeno una chiave. Profili cliente utilizza questa chiave per mappare l'oggetto del profilo personalizzato a un profilo.

La mappatura degli oggetti del profilo personalizzata richiede inoltre almeno una chiave che identifichi in modo univoco l'oggetto in modo che possa essere aggiornato specificando lo stesso valore di questo campo (questi requisiti possono essere soddisfatti con una sola chiave).

Ogni chiave può essere costituita da uno o più campi. 

## Requisiti del campo
<a name="field-requirements"></a>

Una definizione di campo specifica come leggere un valore per quel nome di campo da un oggetto di origine. La definizione del campo specifica anche il tipo di dati memorizzati nel campo.

I nomi dei tipi di oggetto possono essere qualsiasi stringa alfanumerica o i caratteri '-' e '\$1', inoltre non possono iniziare con un carattere '\$1', utilizzato per i tipi di oggetti standard riservati.

# Dettagli della definizione di mappatura dei tipi di oggetto in Amazon Connect Customer Profiles
<a name="object-type-mapping-definition-details"></a>

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](https://aws.amazon.com/blogs/contact-center/unify-and-organize-customer-information-with-amazon-connect-customer-profiles-with-the-pre-built-amazon-s3-connector/). Oppure, guarda questo video su YouTube: [Come integrare i dati del profilo del cliente nelle esperienze dei contact center](https://www.youtube.com/watch?v=LLIEwFel_7c&t=1767s).

## Dettagli sulla definizione del campo
<a name="field-definition-details"></a>

La definizione del campo definisce l'origine, la destinazione (target) e il tipo di campo. 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\$1NUMBER, EMAIL\$1ADDRESS, 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\$1NUMBER, un numero di telefono viene elaborato in modo che gli agenti possano cercarlo in qualsiasi formato: la stringa "\$115551234567" corrisponde a "(555)-123-4567".

## Dettagli chiave della definizione
<a name="key-definition-details"></a>

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'[SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API. 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'[SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API per cercare il valore della chiave e trovare il profilo. 

## Chiavi di ricerca predefinite
<a name="object-type-mapping-default-search-keys"></a>

Le chiavi di ricerca predefinite, come `_phone` e `_email`, sono predefinite dai modelli di oggetti [Profilo standard](standard-profile-definition.md), [Asset standard](standard-asset-definition.md), [Ordine standard](standard-order-definition.md) e [Caso standard](standard-case-definition.md). È possibile utilizzare le chiavi di ricerca predefinite come nome chiave con l'[SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) per trovare un profilo.

# Identificatori standard per l’impostazione degli attributi sulla chiave in Profili dei clienti
<a name="standard-identifiers"></a>

Gli identificatori standard consentono di impostare gli attributi sulla chiave. Decidi quali identificatori utilizzare in base a come desideri che i dati vengano inseriti nei profili. Ad esempio, contrassegna il numero di telefono con l'identificatore PROFILE. Ciò significa che il numero di telefono deve essere considerato un identificatore univoco. Se Profili cliente riceve due contatti con lo stesso numero di telefono, i contatti verranno uniti in un unico profilo. 


| Nome identificatore | Description | 
| --- | --- | 
|  AIR\$1PREFERENCE  |  Questo identificativo indica che questa chiave identifica in modo univoco una preferenza si volo. Quando viene specificato questo identificativo, significa che durante l’importazione Profili dei clienti cerca qualsiasi preferenza di volo a cui è associata questa chiave. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/standard-identifiers.html)  | 
|  AIR\$1BOOKING  |  Questo identificativo indica che questa chiave identifica in modo univoco una prenotazione aerea. Quando viene specificato questo identificativo, significa che durante l’importazione Profili dei clienti cerca qualsiasi prenotazione aerea a cui è associata questa chiave. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/standard-identifiers.html)  | 
|  AIR\$1SEGMENT  |  Questo identificativo indica che questa chiave identifica in modo univoco un segmento di volo. Quando viene specificato questo identificativo, significa che durante l’importazione Profili dei clienti cerca qualsiasi segmento di volo a cui è associata questa chiave. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/standard-identifiers.html)  | 
|  HOTEL\$1PREFERENCE  |  Questo identificativo indica che questa chiave identifica in modo univoco una preferenza di hotel. Quando viene specificato questo identificativo, significa che durante l’importazione Profili dei clienti cerca qualsiasi preferenza di hotel a cui è associata questa chiave. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/standard-identifiers.html)  | 
|  HOTEL\$1STAY\$1REVENUE  |  Questo identificativo indica che questa chiave identifica in modo univoco i ricavi derivanti dai soggiorni in hotel. Quando viene specificato questo identificativo, significa che durante l’importazione Profili dei clienti cerca i ricavi derivanti dai soggiorni in hotel a cui è associata questa chiave. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/standard-identifiers.html)  | 
|  HOTEL\$1RESERVATION  |  Questo identificativo indica che questa chiave identifica in modo univoco una prenotazione alberghiera. Quando viene specificato questo identificativo, significa che durante l’importazione Profili dei clienti cerca ogni prenotazione alberghiera a cui è associata questa chiave. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/standard-identifiers.html)  | 
|  LOYALTY  |  Questo identificativo indica che questa chiave identifica in modo univoco una fidelizzazione. Quando viene specificato questo identificativo, significa che durante l’importazione Profili dei clienti cerca ogni fidelizzazione a cui è associata questa chiave. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/standard-identifiers.html)  | 
|  LOYALTY\$1TRANSACTION  |  Questo identificativo indica che questa chiave identifica in modo univoco una transazione di fidelizzazione. Quando viene specificato questo identificativo, significa che durante l’importazione Profili dei clienti cerca ogni transazione di fidelizzazione a cui è associata questa chiave. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/standard-identifiers.html)  | 
|  LOYALTY\$1PROMOTION  |  Questo identificativo indica che questa chiave identifica in modo univoco una promozione della fidelizzazione. Quando viene specificato questo identificativo, significa che durante l’importazione Profili dei clienti cerca qualsiasi promozione della fidelizzazione a cui è associata questa chiave. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/standard-identifiers.html)  | 
|  UNIQUE  | Questo identificatore deve essere specificato esattamente con un indice per ogni tipo di oggetto. Questa chiave viene utilizzata per identificare in modo univoco gli oggetti del tipo di oggetto per recuperarli o, se necessario, aggiornare un oggetto inviato in un secondo momento.  Tutti i campi che compongono le chiavi UNIQUE devono essere specificati quando si invia un nuovo oggetto o questo viene rifiutato.  | 
|  PROFILE  | Questo identificatore indica che questa chiave identifica in modo univoco un profilo. Quando viene specificato questo identificatore, significa che durante l'importazione Profili cliente cerca qualsiasi profilo a cui è associata questa chiave.  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/standard-identifiers.html)  | 
|  LOOKUP\$1ONLY  | Questo identificatore indica che la chiave non viene archiviata dopo l'importazione dell'oggetto. La chiave deve essere utilizzata solo per determinare il profilo durante l'importazione.  Il valore della chiave non è associato al profilo durante l'importazione, il che significa che non può essere utilizzato per consentire la sua ricerca o l'abbinamento di oggetti successivamente importati alla stessa chiave.    È impossibile specificare una chiave sia come identificatore `UNIQUE` che come identificatore `LOOKUP_ONLY`.   È possibile utilizzare `PROFILE` solo insieme a `LOOKUP_ONLY` se esiste almeno un'altra chiave con l'identificatore `PROFILE` senza gli identificatori `NEW_ONLY` o `LOOKUP_ONLY`. L’unica eccezione è la chiave `_profileId`, che può avere la combinazione degli identificatori `PROFILE` e `LOOKUP_ONLY`.     | 
|  NEW\$1ONLY  | Se il profilo non esiste già prima dell'importazione dell'oggetto, la chiave viene associata al profilo. Altrimenti la chiave viene utilizzata solo per abbinare gli oggetti ai profili.     È impossibile specificare una chiave sia come identificatore `UNIQUE` che come identificatore `NEW_ONLY`.   È possibile utilizzare `PROFILE` solo insieme a `NEW_ONLY` se esiste almeno un'altra chiave con l'identificatore `PROFILE` senza gli identificatori `NEW_ONLY` o `LOOKUP_ONLY`.     | 
|  SECONDARY  | Durante l'abbinamento di un oggetto a un profilo, Profili cliente cerca innanzitutto tutte le chiavi PROFILE che non hanno l'identificatore SECONDARY. Queste vengono considerate per prime. Le chiavi SECONDARY vengono prese in considerazione solo se non viene trovato alcun profilo corrispondente utilizzando queste chiavi.  | 
|  ASSET  | Questo identificatore indica che questa chiave identifica in modo univoco una risorsa. Quando viene specificato questo identificatore, significa che durante l'importazione Profili cliente cerca qualsiasi risorsa a cui è associata questa chiave. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/standard-identifiers.html)  | 
|  ORDER  | Questo identificatore indica che questa chiave identifica in modo univoco un ordine. Quando viene specificato questo identificatore, significa che durante l'importazione Profili cliente cerca qualsiasi ordine a cui sia associata questa chiave. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/standard-identifiers.html)  | 
|  CASE  | Questo identificatore indica che questa chiave identifica in modo univoco un caso. Quando viene specificato questo identificatore, significa che durante l'inserimento Profili cliente cerca ogni caso a cui è associata questa chiave. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/standard-identifiers.html)  | 

## Identificatori compatibili
<a name="standard-identifiers-compatibility"></a>

![\[Matrice che mostra gli identificatori e i nomi delle chiavi consentiti e limitati per diversi tipi di dati.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/standard-identifiers-compatibility-image.png)


# In che modo Profili dei clienti elabora le definizioni chiave
<a name="how-profile-assignment-works"></a>

Quando Profili cliente acquisisce le mappature degli oggetti personalizzate, elabora le definizioni chiave. Il diagramma seguente mostra come elabora gli identificatori standard nelle definizioni chiave per determinare a quale profilo assegnare l'oggetto. 

![\[Diagramma di flusso che mostra il processo di controllo delle chiavi del profilo per l’assegnazione o l’accodamento degli oggetti.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-template1.png)


# In che modo Profili dei clienti aggiunge le chiavi all’indice per le ricerche
<a name="how-keys-are-added-index"></a>

Il diagramma seguente mostra come Profili cliente elabora gli identificatori standard per determinare se mantenere la chiave persistente. 

![\[Un diagramma di flusso che mostra il processo decisionale relativo alle chiavi permanenti in Profili dei clienti in base alla ricerca e ai nuovi criteri relativi agli oggetti.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-template2.png)


Il diagramma di flusso mostra i seguenti passaggi:

1. La chiave `LOOKUP_ONLY` è stata specificata?
   + Se Sì, non mantenere la chiave.

1. Se No, la chiave `NEW_ONLY` è stata specificata?
   + Se No, salva la chiave nell’indice per consentirne l’utilizzo per le ricerche.

1. Se Sì, l’importazione dell’oggetto comporta la creazione di un nuovo profilo? 
   + Se Sì, salva la chiave nell’indice per consentirne l’utilizzo per le ricerche.
   + Se No, non mantenere la chiave nell’indice per ricerche future.

# Mappatura del tipo di oggetto per il profilo standard in Amazon Connect Customer Profiles
<a name="object-type-mapping-standard-profile"></a>

Gli argomenti di questa sezione forniscono la definizione del profilo standard e la mappatura dei tipi di oggetto dalle applicazioni esterne al profilo standard.

**Topics**
+ [Requisiti di AppFlow accesso ad Amazon](appflow-access-requirements-profile.md)
+ [Requisiti di AppIntegrations accesso ad Amazon](standard-profile-appintegrations-requirements.md)
+ [

# Requisiti di EventBridge accesso ad Amazon nei profili dei clienti
](standard-profile-eventbridge-requirements.md)
+ [Definizione di profilo standard](standard-profile-definition.md)
+ [Mappatura degli oggetti Salesforce](mapping-salesforce-objects.md)
+ [Mappatura degli oggetti Zendesk](mapping-zendesk-objects.md)
+ [Mappatura degli oggetti Marketo](mapping-marketo-objects.md)
+ [ServiceNowMappatura degli oggetti](mapping-servicenow-objects.md)
+ [Mappatura degli oggetti del segmento](mapping-segment-objects.md)
+ [Mappatura degli oggetti Shopify](mapping-shopify-objects.md)

# Requisiti di AppFlow accesso ad Amazon nei profili dei clienti
<a name="appflow-access-requirements-profile"></a>

Utilizza i seguenti requisiti di AppFlow accesso Amazon per creare ed eliminare Zendesk, Marketo, Salesforce e le integrazioni ServiceNow con i profili cliente Amazon Connect:
+ appflow: CreateFlow
+ flusso di app: DeleteFlow

# Requisiti di AppIntegrations accesso ad Amazon nei profili dei clienti
<a name="standard-profile-appintegrations-requirements"></a>

Utilizza i seguenti requisiti di AppIntegrations accesso ad Amazon per creare ed eliminare integrazioni di Segment e Shopify con i profili cliente Amazon Connect:


+ integrazioni con app: GetEventIntegration
+ integrazioni con app: ListEventIntegrationAssociations
+ integrazioni con app: CreateEventIntegrationAssociation
+ integrazioni con app: DeleteEventIntegrationAssociation

# Requisiti di EventBridge accesso ad Amazon nei profili dei clienti
<a name="standard-profile-eventbridge-requirements"></a>

Utilizza i seguenti requisiti di EventBridge accesso ad Amazon per creare ed eliminare integrazioni di Segment e Shopify con i profili cliente Amazon Connect:
+ `events:ListTargetsByRule`
+ `events:PutRule`
+ `events:PutTargets`
+ `events:DeleteRule`
+ `events:RemoveTargets`

# Definizione del profilo standard in Amazon Connect Customer Profiles
<a name="standard-profile-definition"></a>

La tabella seguente elenca tutti i campi dell'oggetto profilo standard Profili cliente.


| Campo di profilo standard | Tipo di dati | Descrizione | 
| --- | --- | --- | 
|  ProfileId  | Stringa  | L'identificatore univoco del profilo cliente.  | 
|  AccountNumber  | Stringa  | Un numero di account univoco fornito al cliente. | 
|  AdditionalInformation  | Stringa  | Qualsiasi informazione aggiuntiva pertinente al profilo del cliente. | 
|  PartyType  | Stringa  | Il tipo di profilo utilizzato per descrivere il cliente. Valori validi: INDIVIDUAL \$1 BUSINESS \$1 OTHER | 
|  BusinessName  | Stringa  | Il nome dell'azienda cliente. | 
|  FirstName  | Stringa  | Nome del cliente. | 
|  MiddleName  | Stringa  | Secondo nome del cliente. | 
|  LastName  | Stringa  | Cognome del cliente. | 
|  BirthDate  | Stringa  | Data di nascita del cliente. | 
|  Gender  | Stringa  | Il genere con cui il cliente si identifica. | 
|  PhoneNumber  | Stringa  | Il numero di telefono del cliente, che non è stato specificato come numero di cellulare, di casa o aziendale. | 
|  MobilePhoneNumber  | Stringa  | Numero di telefono del cliente. | 
|  HomePhoneNumber  | Stringa  | Numero di telefono del cliente. | 
|  BusinessPhoneNumber  | Stringa  | Numero di telefono aziendale del cliente. | 
|  EmailAddress  | Stringa  | L'indirizzo e-mail del cliente, che non è stato specificato come indirizzo personale o aziendale. | 
|  PersonalEmailAddress  | Stringa  | L’indirizzo e-mail personale del cliente. | 
|  BusinessEmailAddress  | Stringa  | L'indirizzo e-mail aziendale del cliente. | 
|  Indirizzo  | Indirizzo  | Un indirizzo generico associato al cliente che non si occupa di posta, spedizione o fatturazione. | 
|  ShippingAddress  | Indirizzo  | L'indirizzo di spedizione del cliente. | 
|  MailingAddress  | Indirizzo  | L'indirizzo postale del cliente. | 
|  BillingAddress  | Indirizzo  | L'indirizzo di fatturazione del cliente. | 
|  Attributes  | String-to-string mappa  | Coppia di attributi chiave-valore di un profilo cliente. | 
|  ProfileType  | Stringa  | Il tipo di profilo. Valori validi: PROFILE \$1 ACCOUNT\$1PROFILE  | 
|  EngagementPreferences  | EngagementPreferences  | Le preferenze di interazione del cliente o dell’account. | 

Gli oggetti del profilo standard sono indicizzati in base alle chiavi riportate nella tabella seguente.


| Nome dell’indice standard | Campo di profilo standard | 
| --- | --- | 
| \$1phone | PhoneNumber, MobilePhoneNumber HomePhoneNumber, o BusinessPhoneNumber | 
| \$1email | EmailAddress, PersonalEmailAddress, o BusinessEmailAddress | 
| \$1account | AccountNumber | 
| \$1profileId | ProfileId | 
| \$1fullName | "FirstName MiddleName LastName" | 

Ad esempio, puoi utilizzarlo `_phone` come nome chiave con l'[SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) per trovare un profilo il cui BusinessPhoneNumber attributo PhoneNumber MobilePhoneNumber HomePhoneNumber,, o corrisponde al valore di ricerca.

## Tipo di dati dell'indirizzo
<a name="address-data-type"></a>


| Campo di profilo standard | Tipo di dati | Description | 
| --- | --- | --- | 
|  Address1  | Stringa  | La prima riga dell'indirizzo di un cliente.  | 
|  Address2  | Stringa  | La seconda riga dell'indirizzo di un cliente.  | 
|  Address3  | Stringa  | La terza riga dell'indirizzo di un cliente.  | 
|  Address4  | Stringa  | La quarta riga dell'indirizzo di un cliente.  | 
|  City  | Stringa  | La città in cui vive il cliente.  | 
|  Paese  | Stringa  | Il paese in cui vive il cliente.  | 
|  County  | Stringa  | La contea in cui vive il cliente.  | 
|  PostalCode  | Stringa  | Il codice postale dell'indirizzo del cliente.  | 
|  Province  | Stringa  | La provincia in cui vive il cliente.  | 
|  Stato  | Stringa  | Lo stato in cui vive il cliente.  | 

## EngagementPreferences tipo di dati
<a name="engagement-preferences-data-type"></a>


| Campo di profilo standard | Tipo di dati | Description | 
| --- | --- | --- | 
|  Email  |  Matrice di ContactPreference oggetti  |  Un elenco di preferenze di contatto relative alle e-mail.  | 
|  Telefono  |  Matrice di ContactPreference oggetti  |  Un elenco di preferenze di contatto relative al telefono.  | 

## ContactPreference tipo di dati
<a name="contact-preference-data-type"></a>


| Campo di profilo standard | Tipo di dati | Descrizione | 
| --- | --- | --- | 
|  KeyName  |  Stringa  |  Un identificativo univoco e ricercabile di un profilo cliente.  | 
|  KeyValue  |  Stringa  |  Il valore della chiave utilizzato per cercare il profilo in base a keyName.  | 
|  ProfileId  |  Stringa  |  L'identificatore univoco del profilo cliente.  | 
|  ContactType  |  Stringa  |  Il tipo di contatto utilizzato per l’interazione. Valori validi: PhoneNumber MobilePhoneNumber \$1 HomePhoneNumber \$1 BusinessPhoneNumber \$1 EmailAddress \$1 PersonalEmailAddress \$1 BusinessEmailAddress  | 

# Mappatura degli oggetti Salesforce sul profilo standard in Amazon Connect Customer Profiles
<a name="mapping-salesforce-objects"></a>

Questo argomento elenca i campi degli oggetti Salesforce mappati ai campi dell'oggetto profilo standard in Profili cliente.

## Oggetto Salesforce-Account
<a name="salesforceaccountobject"></a>

Dopo è riportato un elenco di tutti i campi in un oggetto Salesforce-Account. I campi dell'oggetto Salesforce-Account possono variare a seconda della configurazione dell'istanza Salesforce.
+ Id
+ IsDeleted
+ MasterRecordId
+ Name
+ Tipo
+ ParentId
+ BillingStreet
+ BillingCity
+ BillingState
+ BillingPostalCode
+ BillingCountry
+ BillingLatitude
+ BillingLongitude
+ BillingGeocodeAccuracy
+ BillingAddress.Città
+ BillingAddress.Paese
+ BillingAddress.Precisione GeoCode
+ BillingAddress.latitudine
+ BillingAddress.longitudine
+ BillingAddress. Codice postale
+ BillingAddress.stato
+ BillingAddress.strada
+ ShippingStreet
+ ShippingCity
+ ShippingState
+ ShippingPostalCode
+ ShippingCountry
+ ShippingLatitude
+ ShippingLongitude
+ ShippingGeocodeAccuracy
+ ShippingAddress.city
+ ShippingAddress.paese
+ ShippingAddress.latitudine
+ ShippingAddress.longitudine
+ ShippingAddress. Codice postale
+ ShippingAddress.stato
+ ShippingAddress.strada
+ Telefono
+ Fax
+ AccountNumber
+ Website
+ PhotoUrl
+ Sic
+ Industry
+ AnnualRevenue
+ NumberOfEmployees
+ Ownership
+ TickerSymbol
+ Description
+ Rating
+ Site
+ OwnerId
+ CreatedDate
+ CreatedById
+ LastModifiedDate
+ LastModifiedId
+ SystemModstamp
+ LastActivityDate
+ LastViewedDate
+ LastReferencedDate
+ Jigsaw
+ JigsawCompanyId
+ CleanStatus
+ AccountSource
+ DunsNumber
+ Tradestyle
+ NaicsCode
+ NaicsDesc
+ YearStarted
+ SicDesc
+ DandbCompanyId
+ IsBuyer

## Mappatura di un oggetto Salesforce-Account su un profilo standard
<a name="mapping-salesforceaccountobject"></a>

Un sottoinsieme dei campi dell'oggetto Salesforce-Account viene mappato all'oggetto profilo standard in Profili cliente. 

La tabella seguente elenca quali campi possono essere mappati dall'oggetto Salesforce-Account al profilo standard. (La tabella include la mappatura per un'istanza di Salesforce che è stata configurata per includere i campi Person).


| Campo di origine Salesforce-Account | Campo di destinazione del profilo standard | 
| --- | --- | 
|  Id  | Attributi. sfdcAccountId  | 
|  Name  | BusinessName  | 
|  Telefono  | PhoneNumber  | 
|  BillingStreet  | BillingAddress.Indirizzo 1  | 
|  BillingCity  | BillingAddress.Città  | 
|  BillingState  | BillingAddress.Stato  | 
|  BillingCountry  | BillingAddress.Paese  | 
|  BillingPostalCode  | BillingAddress.PostalCode  | 
|  ShippingStreet  | ShippingAddress.Indirizzo 1  | 
|  ShippingCity  | ShippingAddress.Città  | 
|  ShippingState  | ShippingAddress.Stato  | 
|  ShippingCountry  | ShippingAddress.Paese  | 
|  ShippingPostalCode  | ShippingAddress.PostalCode  | 
|  IsPersonAccount  | PartyType  | 
|  PersonMobilePhone  | MobilePhoneNumber  | 
|  PersonHomePhone  | HomePhoneNumber  | 
|  PersonEmail  | PersonalEmailAddress  | 
|  PersonMailingAddress.Strada  | MailingAddress.Indirizzo 1  | 
|  PersonMailingAddress.Città  | MailingAddress.Città  | 
|  PersonMailingAddress.Stato  | MailingAddress.Stato  | 
|  PersonMailingAddress.Paese  | MailingAddress.Paese  | 
|  PersonMailingAddress.PostalCode  | MailingAddress.PostalCode  | 
|  PersonBirthDate  | BirthDate  | 
|  PersonOtherStreet  | Address.Address1  | 
|  PersonOtherCity  | Address.City  | 
|  PersonOtherState  | Indirizzo.Stato  | 
|  PersonOtherCountry  | Address.Country  | 
|  PersonOtherPostalCode  | Indirizzo. PostalCode  | 
|  FirstName  | FirstName  | 
|  LastName  | LastName  | 
|  MiddleName  | MiddleName  | 
|  AccountNumber  | AccountNumber  | 

I dati dei clienti Salesforce-Account dell'oggetto Salesforce sono associati a un profilo cliente Amazon Connect utilizzando gli indici nella tabella seguente. 


| Nome dell'indice standard | Campo di origine Salesforce-Account | 
| --- | --- | 
|  \$1salesforceAccountId  | Id  | 

Ad esempio, puoi utilizzarlo `_salesforceAccountId` come nome chiave con l'[SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API per trovare un profilo. Puoi trovare gli oggetti Salesforce-Account associati a un profilo specifico utilizzando l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API con and set to. `ProfileId` `ObjectTypeName` `Salesforce-Account`

## Oggetto Salesforce-Contact
<a name="salesforcecontactobject"></a>

Di seguito è riportato un elenco di tutti i campi in un oggetto Salesforce-Contact.
+ Id
+ IsDeleted
+ MasterRecordId
+ Accountd
+ LastName
+ FirstName
+ Salutation
+ Name
+ OtherStreet
+ OtherCity
+ OtherState
+ OtherPostalCode
+ OtherCountry
+ OtherLatitude
+ OtherLongitude
+ OtherGeocodeAccuracy
+ OtherAddress.city
+ OtherAddress.country
+ OtherAddress.Precisione del codice geografico
+ OtherAddress.latitudine
+ OtherAddress. Codice postale
+ OtherAddress.stato
+ OtherAddress.strada
+ MailingStreet
+ MailingCity
+ MailingState
+ MailingPostalCode
+ MailingCountry
+ MailingLatitude
+ MailingLongitude
+ MailingGeocodeAccuracy
+ MailingAddress.city
+ MailingAddress.paese
+ MailingAddress.Precisione del codice geografico
+ MailingAddress.latitudine
+ MailingAddress.longitudine
+ MailingAddress. Codice postale
+ MailingAddress.stato
+ MailingAddress.strada
+ Telefono
+ Fax
+ MobilePhone
+ HomePhone
+ OtherPhone
+ AssistantPhone
+ ReportsToId
+ Email
+ Titolo
+ Department
+ AssistantName
+ LeadSource
+ Birthdate
+ Description
+ OwnerId
+ CreatedDate
+ CreatedById
+ LastModifiedDate
+ LastModifiedById
+ SystemModstamp
+ LastActivityDate
+ Ultima data CURequest
+ Ultima CUUpdate data
+ LastViewedDate
+ LastReferencedDate
+ EmailBouncedReason
+ EmailBouncedDate
+ IsEmailBounced
+ PhotoUrl
+ Jigsaw
+ JigawContactId
+ CleanStatus
+ IndividualId

## Mappatura di un oggetto Salesforce-Contact su un profilo standard
<a name="mapping-salesforcecontactobject"></a>

Un sottoinsieme dei campi dell'oggetto Salesforce-Contact viene mappato all'oggetto profilo standard in Profili cliente. La tabella seguente elenca quali campi possono essere mappati dall'oggetto Salesforce-Contact all'oggetto profilo standard.


| Campo di origine Salesforce-Contact | Campo di destinazione del profilo standard | 
| --- | --- | 
|  Id  | Attributi. sfdcContactId  | 
|  AccountId  | Attributi. sfdcAccountId  | 
|  LastName  | LastName  | 
|  FirstName  | FirstName  | 
|  MiddleName  | MiddleName  | 
|  OtherStreet  | Address.Address1  | 
|  OtherCity  | Address.City  | 
|  OtherState  | Indirizzo.Stato  | 
|  OtherCountry  | Address.Country  | 
|  OtherPostalCode  | Indirizzo. PostalCode  | 
|  MailingStreet  | MailingAddress.Indirizzo 1  | 
|  MailingCity  | MailingAddress.Città  | 
|  MailingState  | MailingAddress.Stato  | 
|  MailingCountry  | MailingAddress.Paese  | 
|  MailingPostalCode  | MailingAddress.PostalCode  | 
|  Telefono  | PhoneNumber  | 
|  HomePhone  | HomePhoneNumber  | 
|  MobilePhone  | MobilePhoneNumber  | 
|  Email  | EmailAddress  | 
|  Birthdate  | BirthDate  | 

I dati dei clienti Salesforce-Contact di un oggetto Salesforce sono associati a un profilo cliente Amazon Connect utilizzando gli indici nella tabella seguente. 


| Nome dell'indice standard | Campo di origine Salesforce-Contact | 
| --- | --- | 
|  \$1salesforceContactId  | Id  | 
|  \$1salesforceAccountId  | AccountId  | 

Ad esempio, puoi utilizzare `_salesforceAccountId` e `_salesforceContactId` come nome chiave con l'[SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API per trovare un profilo. Puoi trovare gli oggetti Salesforce-Contact associati a un profilo specifico utilizzando l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API con and set to. `ProfileId` `ObjectTypeName` `Salesforce-Contact`

# Mappatura degli oggetti Zendesk sul profilo standard in Amazon Connect Customer Profiles
<a name="mapping-zendesk-objects"></a>

Questo argomento elenca i campi degli oggetti Zendesk mappati ai campi del profilo standard in Profili cliente.

## Oggetto Zendesk-users
<a name="zendeskusersobject"></a>

Di seguito è riportato un elenco di tutti i campi in un oggetto Zendesk-users.
+ id
+ url
+ external\$1id
+ e-mail
+ attiva
+ chat\$1only
+ customer\$1role\$1id
+ role\$1type
+ details
+ last\$1login\$1at
+ locale
+ locale\$1id
+ moderator
+ notes
+ only\$1private\$1comments
+ default\$1group\$1id
+ telefono
+ shared\$1phone\$1number
+ photo
+ restricted\$1agent
+ role
+ shared
+ tag
+ signature
+ suspended
+ ticket\$1restriction
+ time\$1zone
+ two\$1factor\$1auth\$1enabled
+ user\$1fields
+ verified
+ report\$1csv
+ created\$1at
+ aggiornato\$1at

## Mappatura degli utenti Zendesk su un profilo standard
<a name="mapping-zendeskusersobject"></a>

Un sottoinsieme dei campi dell'oggetto Zendesk-Users viene mappato al profilo standard in Profili cliente. La tabella seguente elenca quali campi possono essere mappati dall'oggetto Zendesk-Users al profilo standard.


| Campo di origine Zendesk-Users | Campo di destinazione del profilo standard | 
| --- | --- | 
|  id  | Attributi. ZendeskUserId  | 
|  external\$1id  | Attributi. ZendeskExternalId  | 
|  e-mail  | EmailAddress  | 
|  telefono  | PhoneNumber  | 

I dati dei clienti degli utenti Zendesk dell'oggetto Zendesk sono associati a un profilo cliente Amazon Connect utilizzando i seguenti indici. 


| Nome dell'indice standard | Campo di origine ZenDesk-user | 
| --- | --- | 
|  \$1zendeskUserId  | Id  | 
|  \$1zendeskExternalId  | external\$1id  | 

Ad esempio, puoi utilizzare `_zendeskUserId` e `_zendeskExternalId` come nome chiave con l'[SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API per trovare un profilo cliente Amazon Connect. Puoi trovare gli oggetti Zendesk-Users associati a un profilo cliente specifico utilizzando l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API con `ProfileId` e `ObjectTypeName` impostata su. `Zendesk-users`

# Mappatura degli oggetti Marketo sul profilo standard in Amazon Connect Customer Profiles
<a name="mapping-marketo-objects"></a>

Questo argomento elenca i campi degli oggetti Marketo mappati ai campi dell'oggetto del profilo standard in Profili cliente.

## Oggetto Marketo-leads
<a name="marketo-objects"></a>

Di seguito è riportato un elenco di tutti i campi in un oggetto Marketo-leads
+ id
+ firstName
+ lastName
+ middleName
+ e-mail
+ telefono
+ mobilePhone
+ billingStreet
+ billingCity
+ billingState
+ billingCountry
+ billingPostalCode
+ address
+ città
+ stato
+ paese
+ postalcode
+ gender
+ dateOfBirth

## La mappatura di Marketo-leads a un profilo standard
<a name="mapping-marketo-leads-object"></a>

Un sottoinsieme di campi nell'oggetto Marketo-leads viene mappato al profilo standard.


| Campo di origine Marketo-leads | Campo di destinazione del profilo standard | 
| --- | --- | 
|  id  | Attributi. MarketoLeadId  | 
|  sfdcAccountId  | Attributi. sfdcAccountId  | 
|  sfdcContactId  | Attributi. sfdcContactId  | 
|  firstName  | FirstName  | 
|  lastName  | LastName  | 
|  middleName  | MiddleName  | 
|  e-mail  | EmailAddress  | 
|  telefono  | PhoneNumber  | 
|  mobilePhone  | MobilePhoneNumber  | 
|  mobilePhone  | MobilePhoneNumber  | 
|  billingStreet  | BillingAddress.Indirizzo 1  | 
|  billingCity  | BillingAddress.Città  | 
|  billingState  | BillingAddress.Stato  | 
|  billingCountry  | BillingAddress.Paese  | 
|  billingPostalCode  | BillingAddress.PostalCode  | 
|  address  | Address.Address1  | 
|  città  | Address.City  | 
|  stato  | Indirizzo.Stato  | 
|  paese  | Address.Country  | 
|  postalcode  | Indirizzo. PostalCode  | 
|  gender  | Gender  | 
|  dataOfBirth  | BirthDate  | 

I dati sui clienti Marketo-leads di Marketo sono associati a un profilo cliente Amazon Connect utilizzando gli indici riportati nella tabella seguente. 


| Nome dell'indice standard | Campo di origine Marketo-leads | 
| --- | --- | 
|  \$1marketoLeadId  | id  | 
|  \$1salesforceAccountId  | sfdcAccountId  | 
|  \$1salesforceContactId  | sfdcContactId  | 

Ad esempio, puoi utilizzare `_marketoLeadId``_salesforceAccountId`, e `_salesforceContactId` come nome chiave con l'[SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API per trovare un profilo cliente Amazon Connect. Puoi trovare gli oggetti Marketo-leads associati a un profilo cliente specifico utilizzando l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API con `ProfileId` e `ObjectTypeName` impostata su. `Marketo-leads`

# Mappatura ServiceNow degli oggetti all'oggetto profilo standard nei profili dei clienti di Amazon Connect
<a name="mapping-servicenow-objects"></a>

Questo argomento elenca i campi negli ServiceNow oggetti mappati ai campi dell'oggetto profilo standard in Amazon Connect Customer Profiles.

## Servicenow-sys\$1user object
<a name="servicenow-sys-user-object"></a>

Di seguito è riportato un elenco di tutti i campi in un oggetto ServiceNow-Sys\$1User
+ sys\$1id
+ attiva
+ building
+ calendar\$1integration
+ città
+ company
+ cost\$1center
+ paese
+ date\$1format
+ default\$1perspective
+ department
+ edu\$1status
+ e-mail
+ employee\$1number
+ abilitare\$1multifactor\$1authn
+ failed\$1attempts
+ first\$1name
+ gender
+ home\$1phone
+ internal\$1integration\$1user
+ introduction
+ last\$1login
+ last\$1login\$1device
+ tempo\$1di\$1ultimo accesso
+ last\$1name
+ last\$1password
+ ldap\$1server
+ location
+ locked\$1out
+ manager
+ middle\$1name
+ mobile\$1phone
+ nome
+ notification
+ password\$1needs\$1reset
+ telefono
+ photo
+ preferred\$1language
+ roles
+ schedule
+ origine
+ stato
+ street
+ sys\$1class\$1name
+ sys\$1created\$1by
+ sys\$1created\$1on
+ sys\$1domain.link
+ sys\$1domain.value
+ sys\$1domain\$1path
+ sys\$1id
+ sys\$1mod\$1count
+ sys\$1updated\$1by
+ sys\$1updated\$1on
+ time\$1format
+ time\$1zone
+ titolo
+ user\$1name
+ user\$1password
+ web\$1service\$1access\$1only
+ zip

## Mappatura di Servicenow-sys\$1users su un oggetto del profilo standard
<a name="mapping-servicenow-sys-user-object"></a>

Un sottoinsieme dei campi dell'oggetto ServiceNow-Sys\$1Users viene mappato all'oggetto del profilo standard in Profili cliente. 

La tabella seguente elenca quali campi possono essere mappati dall'oggetto ServiceNow-sys\$1users al profilo standard.


| Campo sorgente ServiceNow-sys\$1users | Campo di destinazione dei profili dei clienti | 
| --- | --- | 
|  sys\$1id  | Attributi. ServiceNowSystemId  | 
|  first\$1name  | FirstName  | 
|  last\$1name  | LastName  | 
|  middle\$1name  | MiddleName  | 
|  gender  | Gender  | 
|  e-mail  | EmailAddress  | 
|  telefono  | PhoneNumber  | 
|  home\$1phone  | HomePhoneNumber  | 
|  mobile\$1phone  | MobilePhoneNumber  | 
|  street  | Address.Address1  | 
|  città  | Address.City  | 
|  stato  | Indirizzo.Stato  | 
|  paese  | Address.Country  | 
|  zip  | Indirizzo. PostalCode  | 

I dati dei clienti Servicenow-sys\$1user dell'oggetto Servicenow sono associati a un profilo cliente Amazon Connect utilizzando gli indici nella tabella seguente. 


| Nome dell'indice standard | Campo di origine Servicenow-sys\$1user | 
| --- | --- | 
|  \$1 serviceNowSystem Identificazione  | sys\$1id  | 

Ad esempio, puoi utilizzare `_serviceNowSystemId` e `_serviceNowIncidentId` come nome chiave con l'[SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API per trovare un profilo cliente Amazon Connect. Puoi trovare gli oggetti ServiceNow-Sys\$1User associati a un profilo specifico utilizzando l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API con and set to. `ProfileId` `ObjectTypeName` `Servicenow-sys_user`

# Mappatura degli oggetti Segment all’oggetto del profilo standard in Amazon Connect Customer Profiles
<a name="mapping-segment-objects"></a>

Questo argomento elenca i campi degli oggetti Segment mappati ai campi dell'oggetto del profilo standard in Profili cliente Amazon Connect.

## Oggetto Segment-Identify
<a name="segment-identify-object"></a>

Di seguito è riportato un elenco di tutti i campi in un oggetto Segment-Identify.
+ userId
+ campi comuni: vedi [Spec: Common Fields](https://segment.com/docs/connections/spec/common/) nella documentazione del segmento
+ Caratteristiche riservate di Segment: consulta [Caratteristiche](https://segment.com/docs/connections/spec/identify/#traits) nella documentazione di Segment
+ traits.address.street 
+ traits.address.city
+ traits.address.state
+ traits.address. codice postale
+ traits.address.country
+ traits.age
+ tratti.avatar
+ tratti.compleanno
+ tratti.nome.azienda
+ traits.company.id
+ traits.company.industry
+ traits.company.employee\$1count
+ traits.company.plan
+ traits.createdAt
+ traits.description
+ traits.email
+ traits.firstName
+ traits.gender
+ traits.id
+ traits.lastName
+ traits.name
+ traits.phone
+ traits.title
+ traits.username
+ traits.website

## Mappatura di un Segment-Identify su un oggetto del profilo standard
<a name="mapping-segment-identify-object"></a>

Un sottoinsieme dei campi dell'oggetto Segment-Identify viene mappato all'oggetto del profilo standard in Profili cliente. 

La tabella seguente elenca quali campi possono essere mappati dall'oggetto Segment-Identify al profilo standard.


| Campo di origine Segment-Identify | Campo di destinazione del profilo standard | 
| --- | --- | 
|  | Campo di destinazione del profilo standard | 
| userId | Attributi. SegmentUserId | 
| tratti.nome.azienda | BusinessName | 
| traits.firstName | FirstName | 
| traits.lastName | LastName | 
| tratti.compleanno | BirthDate | 
| traits.gender | Gender | 
| traits.phone | PhoneNumber | 
| traits.email | EmailAddress | 
| traits.address.street | Address.Address1 | 
| traits.address.city | Address.City | 
| traits.address.state | Indirizzo.Stato | 
| traits.address.country | Address.Country | 
| traits.address. codice postale | Indirizzo. PostalCode | 

### Esempio
<a name="example-mapping-segment-identify-object"></a>

L'esempio seguente mostra come mappare un campo origine a un campo di destinazione.

```
"segmentUserId": {
    "Source": "_source.detail.event.detail.userId",
    "Target": "_profile.Attributes.SegmentUserId"
}
```

I dati dei clienti Segment-Identify dall'oggetto Segment sono associati a un profilo cliente Amazon Connect utilizzando il seguente indice. 


| Nome dell'indice standard | Campo di origine Segment-Identify | 
| --- | --- | 
|  \$1segmentUserId  |  userId  | 

Ad esempio, puoi utilizzarlo `_segmentUserId` come nome chiave con l'[SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API per trovare un profilo cliente Amazon Connect. Puoi trovare gli oggetti Segment-Identify associati a un profilo specifico utilizzando l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API con `ProfileId` and `ObjectTypeName` set to. `Segment-Identify`

# Mappatura degli oggetti Shopify all’oggetto del profilo standard in Amazon Connect Customer Profiles
<a name="mapping-shopify-objects"></a>

Questo argomento elenca i campi degli oggetti Shopify mappati ai campi dell'oggetto del profilo standard in Profili cliente Amazon Connect.

## Oggetto Shopify-Customer
<a name="shopify-identify-object"></a>

Di seguito è riportato un elenco di tutti i campi in un oggetto Shopify-Customer.


+ accepts\$1marketing
+ accepts\$1marketing\$1updated\$1at
+ addresses
+ currency
+ created\$1at
+ default\$1address.address1
+ default\$1address.address2
+ default\$1address.city
+ default\$1address.company
+ default\$1address.country
+ default\$1address.country\$1code
+ default\$1address.country\$1name
+ default\$1address.customer\$1id
+ default\$1address.default
+ default\$1address.first\$1name
+ default\$1address.id
+ default\$1address.last\$1name
+ default\$1address.name
+ default\$1address.phone
+ default\$1address.province
+ default\$1address.province\$1code
+ default\$1address.zip
+ e-mail
+ first\$1name
+ id
+ last\$1name
+ last\$1order\$1id
+ last\$1order\$1name
+ metafield.key
+ metafield.value
+ metafield.namespace
+ metafield.value\$1type
+ marketing\$1opt\$1in\$1level
+ multipass\$1identifier
+ note
+ orders\$1count
+ telefono
+ sms\$1marketing\$1consent.state
+ sms\$1marketing\$1consent.opt\$1in\$1level
+ sms\$1marketing\$1consent.consent\$1updated\$1it
+ sms\$1marketing\$1consent.consent\$1collected\$1from
+ stato
+ tag
+ tax\$1exempt
+ tax\$1exemptions
+ total\$1spent
+ aggiornato\$1at
+ verified\$1email

## Mappatura di un oggetto Shopify-Customer su un profilo standard
<a name="mapping-shopify-customer-object"></a>

Un sottoinsieme dei campi dell'oggetto Shopify-Customer viene mappato all'oggetto del profilo standard in Profili cliente. 

La tabella seguente elenca quali campi possono essere mappati dall'oggetto Shopify-Customer al profilo standard.


| Campo origine Shopify-Customer | Campo di destinazione del profilo standard | 
| --- | --- | 
| id | Attributi. ShopifyCustomerId | 
| email | EmailAddress | 
| first\$1name | FirstName | 
| last\$1name | LastName | 
| note | AdditionalInformation | 
| phone | PhoneNumber | 
| default\$1address.address1 | Address.Address1 | 
| default\$1address.address2 | Address.Address2 | 
| default\$1address.city | Address.City | 
| default\$1address.province | Address.Province | 
| default\$1address.country | Address.Country | 
| default\$1address.zip | Indirizzo. PostalCode | 

### Esempio
<a name="example-mapping-shopify-customer-object"></a>

L'esempio seguente mostra come mappare un campo origine a un campo di destinazione.

```
"shopifyCustomerId": {
    "Source": "_source.detail.event.detail.payload.id",
    "Target": "_profile.Attributes.ShopifyCustomerId"
}
```

I dati dei clienti Shopify-Customer dell'oggetto Shopify sono associati a un profilo cliente Amazon Connect utilizzando il seguente indice.


| Nome dell'indice standard | Campo origine Shopify-Customer | 
| --- | --- | 
| \$1shopifyCustomerId | id | 

Ad esempio, puoi utilizzarlo `_shopifyCustomerId` come nome chiave con l'[SearchProfiles](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html)API per trovare un profilo cliente Amazon Connect. Puoi trovare gli oggetti Shopify-Customer associati a un profilo specifico utilizzando l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API con e impostata su. `ProfileId` `ObjectTypeName` `Shopify-Customer`

# La mappatura del tipo di oggetto all’ordine standard in Amazon Connect Customer Profiles
<a name="object-type-mapping-standard-order"></a>

Gli argomenti di questa sezione forniscono la definizione standard degli ordini e la mappatura dei tipi di oggetti da applicazioni esterne all'ordine standard.

**Topics**
+ [Requisiti di AppIntegrations accesso ad Amazon](standard-order-appintegrations-requirements.md)
+ [Requisiti di EventBridge accesso ad Amazon](standard-order-eventbridge-requirements.md)
+ [Definizione dell'ordine standard](standard-order-definition.md)
+ [Mappatura degli oggetti Shopify](mapping-shopify-objects-standard-order.html.md)

# Requisiti di AppIntegrations accesso ad Amazon
<a name="standard-order-appintegrations-requirements"></a>

Utilizza i seguenti requisiti di AppIntegrations accesso ad Amazon per creare ed eliminare integrazioni Shopify con i profili cliente Amazon Connect:
+ integrazioni con app: GetEventIntegration
+ integrazioni con app: ListEventIntegrationAssociations
+ integrazioni con app: CreateEventIntegrationAssociation
+ integrazioni con app: DeleteEventIntegrationAssociation

# Requisiti di EventBridge accesso ad Amazon
<a name="standard-order-eventbridge-requirements"></a>

Utilizza i seguenti requisiti di EventBridge accesso ad Amazon per creare ed eliminare integrazioni Shopify con i profili cliente Amazon Connect:
+ `events:ListTargetsByRule`
+ `events:PutRule`
+ `events:PutTargets`
+ `events:DeleteRule`
+ `events:RemoveTargets`

# Campi dell’oggetto dell’ordine standard di Profili dei clienti.
<a name="standard-order-definition"></a>

La tabella seguente elenca tutti i campi dell'oggetto dell'ordine standard in Profili cliente.


| Campo dell’ordine standard | Tipo di dati | Descrizione | 
| --- | --- | --- | 
| OrderId | Stringa | L’identificativo univoco di un ordine standard. | 
| CustomerEmail | Stringa | L’indirizzo e-mail del cliente. | 
| CustomerPhone | Stringa | Il numero di telefono del cliente. | 
| CreatedDate | Stringa | La data di creazione dell’ordine. | 
| UpdatedDate | Stringa | La data di aggiornamento dell’ordine. | 
| ProcessedDate | Stringa | La data di elaborazione dell’ordine. | 
| ClosedDate | Stringa | La data di chiusura dell’ordine. | 
| CancelledDate | Stringa | La data dell’ordine è stata annullata. | 
| CancelReason | Stringa | Motivo dell’annullamento dell’ordine. | 
| Name | Stringa | Il nome dell’ordine. | 
| AdditionalInformation | Stringa | Qualsiasi informazione aggiuntiva pertinente all’ordine. | 
| Gateway | Stringa | Il gateway di pagamento dell’ordine. | 
| Status | Stringa | Lo stato dell’ordine. | 
| StatusCode | Stringa | Il codice di stato dell’ordine. Valori validi: DRAFT \$1 ACTIVATED | 
| StatusUrl | Stringa | L’URL di stato dell’ordine. | 
| CreditCardNumber | Stringa | Le ultime quattro cifre della carta di credito del cliente. | 
| CreditCardCompany | Stringa | La società emittente della carta di credito del cliente. | 
| FulfillmentStatus | Stringa | Lo stato di evasione dell’ordine. | 
| TotalPrice | Stringa | Il prezzo totale dell’ordine. | 
| TotalTax | Stringa | L’imposta totale dell’ordine. | 
| TotalDiscounts | Stringa | Gli sconti totali dell’ordine. | 
| TotalItemsPrice | Stringa | Il prezzo totale degli articoli dell’ordine. | 
| TotalShippingPrice | Stringa | Il prezzo di spedizione totale dell’ordine. | 
| TotalTipReceived | Stringa | La mancia totale dell’ordine ricevuta. | 
| Valuta | Stringa | La valuta dell’ordine. | 
| TotalWeight | Stringa | Il peso totale dell’ordine. | 
| BillingAddress | OrderAddress | L'indirizzo di fatturazione del cliente. | 
| ShippingAddress | OrderAddress | L'indirizzo di spedizione del cliente. | 
| OrderItems | OrderItem elenco | Gli articoli dell’ordine. | 
| Attributes | String-to-string mappa | Coppia di attributi chiave-valore di un caso standard. | 

Gli oggetti dell’ordine standard sono indicizzati in base alle chiavi riportate nella tabella seguente.


| Nome dell’indice standard | Campo dell’ordine standard | 
| --- | --- | 
| \$1orderId | OrderId | 

Ad esempio, puoi utilizzarlo `_orderId` come nome chiave con l'[SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) per trovare un profilo con un ordine che OrderId corrisponda al valore di ricerca. È possibile trovare gli oggetti di ordine standard associati a un profilo specifico utilizzando l'[ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) con `ProfileId` and `ObjectTypeName` set to`_order`.

## OrderAddress tipo di dati
<a name="orderaddress-data-type"></a>


| Campo dell’ordine standard | Tipo di dati | Description | 
| --- | --- | --- | 
| Nome | Stringa | Il nome associato all’indirizzo di un ordine. | 
| Address1 | Stringa | La prima riga dell’indirizzo di un ordine. | 
| Address2 | Stringa | La seconda riga dell’indirizzo di un ordine. | 
| Address3 | Stringa | La terza riga dell’indirizzo di un ordine. | 
| Address4 | Stringa | La quarta riga dell’indirizzo di un ordine. | 
| City | Stringa | La città dell’indirizzo di un ordine. | 
| County | Stringa | La contea dell’indirizzo di un ordine. | 
| Stato | Stringa | Lo stato dell’indirizzo di un ordine. | 
| Province | Stringa | La provincia dell’indirizzo di un ordine. | 
| Paese | Stringa | Il paese dell’indirizzo di un ordine. | 
| PostalCode | Stringa | Il codice postale dell’indirizzo di un ordine. | 

## OrderItem tipo di dati
<a name="orderitem-data-type"></a>


| Campo dell’ordine standard | Tipo di dati | Description | 
| --- | --- | --- | 
| Titolo | Stringa | Il titolo di un articolo dell’ordine. | 
| Prezzo | Stringa | Il prezzo di un articolo dell’ordine. | 
| Quantità | Stringa | La quantità di un articolo dell’ordine. | 

# Mappatura degli oggetti Shopify sull’ordine standard in Amazon Connect Customer Profiles
<a name="mapping-shopify-objects-standard-order.html"></a>

Questo argomento elenca i campi degli oggetti Shopify mappati ai campi dell'oggetto dell'ordine standard in Profili cliente.

## Oggetto Shopify DraftOrder
<a name="shopify-draftorder-object.html"></a>

Per un elenco di tutti i campi di un oggetto Shopify, consulta [L'DraftOrder DraftOrder oggetto](https://shopify.dev/api/admin-rest/2021-10/resources/draftorder#resource_object) nella documentazione di Shopify.

## Mappatura di un oggetto Shopify- a un ordine standard DraftOrder
<a name="shopify-draftorder-object-standardorder.html"></a>

Un sottoinsieme dei campi dell'oggetto Shopify viene mappato all'DraftOrder oggetto dell'ordine standard nei profili dei clienti.

La tabella seguente elenca quali campi possono essere mappati dall'oggetto Shopify all'ordine standard. DraftOrder 

 `StatusCode` è `ACTIVATED` se `order_status_url` esiste nell'origine. In caso contrario `StatusCode` è `DRAFT`.


|  Shopify- campo source DraftOrder  |  Campo di destinazione dell’ordine standard  | 
| --- | --- | 
| id | Attributi. ShopifyOrderId | 
| customer.id | Attributi. ShopifyCustomerId | 
| note | AdditionalInformation | 
| e-mail | CustomerEmail | 
| currency | Valuta | 
| created\$1at | CreatedDate | 
| updated\$1at | UpdatedDate | 
| nome | Name | 
| status | Status | 
| order\$1status\$1url | StatusCode | 
| billing\$1address.address1 | BillingAddress.Indirizzo 1 | 
| billing\$1address.address2 | BillingAddress.Indirizzo 2 | 
| billing\$1address.city | BillingAddress.Città | 
| billing\$1address.zip | BillingAddress.PostalCode | 
| billing\$1address.province | BillingAddress.Provincia | 
| billing\$1address.country | BillingAddress.Paese | 
| billing\$1address.name | BillingAddress.Nome | 
| shipping\$1address.address1 | ShippingAddress.Indirizzo 1 | 
| shipping\$1address.address2 | ShippingAddress.Indirizzo 2 | 
| shipping\$1address.city | ShippingAddress.Città | 
| shipping\$1address.zip | ShippingAddress.PostalCode | 
| shipping\$1address.province | ShippingAddress.Provincia | 
| shipping\$1address.country | ShippingAddress.Paese | 
| shipping\$1address.name | ShippingAddress.Nome | 
| invoice\$1url | StatusUrl | 
| total\$1price | TotalPrice | 
| total\$1tax | TotalTax | 
| line\$1items[].title | OrderItems[] .Titolo | 
| line\$1items[].price | OrderItems[] .Prezzo | 
| line\$1items[].quantity | OrderItems[] .Quantità | 

### Esempio
<a name="example-shopify-draftorder-object-standardorder.html"></a>

L'esempio seguente mostra come mappare un campo origine a un campo di destinazione.

```
"shopifyOrderId": {
    "Source": "_source.detail.event.detail.payload.id",
    "Target": "_order.Attributes.ShopifyOrderId"
}
```

I dati dei DraftOrder clienti Shopify dell'oggetto Shopify sono associati a un ordine standard Amazon Connect utilizzando il seguente indice.


| Nome dell'indice standard  | Shopify- campo source DraftOrder  | 
| --- | --- | 
| \$1shopifyOrderId | id | 

Ad esempio, puoi utilizzare `_shopifyOrderId` come strumento `ObjectFilter.KeyName` l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API per trovare un ordine standard. Puoi trovare gli DraftOrder oggetti Shopify- associati a un profilo specifico utilizzando l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API con `ProfileId` and `ObjectTypeName` set to. `Shopify-DraftOrder`

## Oggetto Shopify-Order
<a name="shopify-order-object.html"></a>

Per un elenco di tutti i campi di un oggetto Shopify-Order, consulta [L'oggetto Ordine](https://shopify.dev/api/admin-rest/2021-10/resources/order#resource_object) nella documentazione di Shopify.

## Mappatura di un oggetto Shopify-Order su un ordine standard
<a name="mapping-shopify-order-object-standarorder.html"></a>

Un sottoinsieme dei campi dell'oggetto Shopify-Order viene mappato all'oggetto dell'ordine standard nei profili dei clienti.

La tabella seguente elenca quali campi possono essere mappati dall'oggetto Shopify-Order all'ordine standard.

`StatusCode` è `ACTIVATED` se `order_status_url` esiste nell'origine. In caso contrario `StatusCode` è `DRAFT`.


| Campo origine Shopify-Order | Campo di destinazione dell’ordine standard | 
| --- | --- | 
| id | Attributi. ShopifyOrderId | 
| customer.id | Attributi. ShopifyCustomerId | 
| cancelled\$1at | CancelledDate | 
| cancel\$1reason | CancelReason | 
| closed\$1at | ClosedDate | 
| created\$1at | CreatedDate | 
| currency | Valuta | 
| e-mail | CustomerEmail | 
| financial\$1status | Status | 
| order\$1status\$1url | StatusCode | 
| fulfillment\$1status | FulfillmentStatus | 
| gateway | Gateway | 
| nome | Name | 
| note | AdditionalInformation | 
| order\$1status\$1url | StatusUrl | 
| telefono | CustomerPhone | 
| processed\$1at | ProcessedDate | 
| total\$1discounts | TotalDiscounts | 
| total\$1line\$1items\$1price | TotalItemsPrice | 
| total\$1price | TotalPrice | 
| total\$1shipping\$1price\$1set.shop\$1money.amount | TotalShippingPrice | 
| total\$1tax | TotalTax | 
| total\$1tip\$1received | TotalTipReceived | 
| total\$1weight | TotalWeight | 
| updated\$1at | UpdatedDate | 
| billing\$1address.address1 | BillingAddress.Indirizzo 1 | 
| billing\$1address.address2 | BillingAddress.Indirizzo 2 | 
| billing\$1address.city | BillingAddress.Città | 
| billing\$1address.zip | BillingAddress.PostalCode | 
| billing\$1address.province | BillingAddress.Provincia | 
| billing\$1address.country | BillingAddress.Paese | 
| billing\$1address.name | BillingAddress.Nome | 
| payment\$1details.credit\$1card\$1number | CreditCardNumber | 
| payment\$1details.credit\$1card\$1company | CreditCardCompany | 
| shipping\$1address.address1 | ShippingAddress.Indirizzo 1 | 
| shipping\$1address.address2 | ShippingAddress.Indirizzo 2 | 
| shipping\$1address.city | ShippingAddress.Città | 
| shipping\$1address.zip | ShippingAddress.PostalCode | 
| shipping\$1address.province | ShippingAddress.Provincia | 
| shipping\$1address.country | ShippingAddress.Paese | 
| shipping\$1address.name | ShippingAddress.Nome | 
| line\$1items[].title | OrderItems[] .Titolo | 
| line\$1items[].price | OrderItems[] .Prezzo | 
| line\$1items[].quantity | OrderItems[] .Quantità | 

### Esempio
<a name="example-shopify-draftorder-object-standardorder.html"></a>

L'esempio seguente mostra come mappare un campo origine a un campo di destinazione.

```
"shopifyOrderId": {
    "Source": "_source.detail.event.detail.payload.id",
    "Target": "_order.Attributes.ShopifyOrderId"
}
```

I dati dei clienti Shopify-Order dall'oggetto Shopify sono associati a un ordine standard Amazon Connect utilizzando il seguente indice.


| Nome dell'indice standard | Campo origine Shopify-Order | 
| --- | --- | 
| \$1shopifyOrderId | id | 

Ad esempio, puoi utilizzare l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API in modalità `ObjectFilter.KeyName` «`_shopifyOrderId`as and» per trovare un ordine standard. Puoi trovare gli oggetti Shopify-Order associati a un profilo specifico utilizzando l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API con and set to. `ProfileId` `ObjectTypeName` `Shopify-Order`

# Mappatura del tipo di oggetto per il record di comunicazione standard
<a name="object-type-mapping-standard-communiction-record"></a>

Gli argomenti di questa sezione forniscono la definizione del record di comunicazione standard e la mappatura del tipo di oggetto dagli eventi della campagna al record di comunicazione standard.

**Topics**
+ [Campi dell’oggetto record di comunicazione standard di Profili dei clienti.](customer-profiles-standard-communication-record-object-fields.md)
+ [Mappatura degli oggetti Campaign al record di comunicazione standard in Amazon Connect Customer Profiles](mapping-campaign-objects-to-the-standard-communication-record-in-amazon-connect-customer-profiles.md)

# Campi dell’oggetto record di comunicazione standard di Profili dei clienti.
<a name="customer-profiles-standard-communication-record-object-fields"></a>

 La tabella seguente elenca tutti i campi nell’oggetto record di comunicazione standard in Profili dei clienti. 


|  Campo communicationRecord standard  |  Tipo di dati  |  Descrizione  | 
| --- | --- | --- | 
|  CommunicationRecordId  |  Stringa  |  L’identificativo univoco di un record di comunicazione standard.  | 
|  Canale  |  Stringa  |  Il metodo utilizzato per contattare il tuo contact center. Ad esempio: VOICE, CHAT, EMAIL  | 
|  ConnectInstanceArn  |  Stringa  |  L'ARN dell'istanza AWS Connect.  | 
|  CreatedDate  |  Stringa  |  Il timestamp che indica quando è stato creato il record di comunicazione.  | 
|  UpdatedDate  |  Stringa  |  Il timestamp che indica l’ultimo aggiornamento del record di comunicazione.  | 
|  LastEventType  |  Stringa  |  Il tipo di evento dell’ultimo evento importato per questa comunicazione.  | 
|  Campagna  |  Campagna  |  Dettagli sulla campagna associata a questa comunicazione.  | 
|  Endpoint  |  Endpoint  |  Informazioni sull’endpoint utilizzato per questa comunicazione.  | 
|  Eventi  |  Map<String, Event>  |  Una mappa degli eventi in cui la chiave è il tipo di evento, ad esempio e-mail recapitata, aperta o cliccata. Tiene traccia dell’ultimo evento di ogni tipo di evento unico che si è verificato durante questa comunicazione.  | 
|  Attributes  |  Mappa <String, String>  |  Coppia di attributi chiave-valore di un record di comunicazione standard.  | 

 Gli oggetti del record di comunicazione standard sono indicizzati in base alle chiavi riportate nella tabella seguente. 


|  Nome dell’indice standard  |  Campo di registrazione delle comunicazioni standard  | 
| --- | --- | 
|  \$1communicationRecordId  |  CommunicationRecordId  | 

 Ad esempio, puoi utilizzarlo `_communicationRecordId` come nome chiave con l'[SearchProfiles](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_SearchProfiles.html)API per trovare un profilo con un record di comunicazione che `CommunicationRecordId` corrisponda al valore di ricerca. È possibile trovare gli `communicationRecord` oggetti standard associati a un profilo specifico utilizzando l'[ListProfileObjects](https://docs.aws.amazon.com/connect/latest/APIReference/API_connect-customer-profiles_ListProfileObjects.html)API con `ProfileId` and `ObjectTypeName` set to`_communicationRecord`. 

## Tipo di dati della campagna
<a name="campaign-data-type"></a>


|  Campo  |  Tipo di dati  |  Descrizione  | 
| --- | --- | --- | 
|  CampaignId  |  Stringa  |  L’ID univoco per la campagna in uscita.  | 
|  CampaignName  |  Stringa  |  Il nome della campagna in uscita.  | 
|  CampaignRunId  |  Stringa  |  L’ID univoco per una specifica esecuzione della campagna.  | 
|  CampaignActivityId  |  Stringa  |  L'ID univoco dell'attività all'interno della campagna.  | 
|  SegmentArn  |  Stringa  |  L’ARN di un segmento di utenti.  | 

## Tipo di dati dell’endpoint
<a name="endpoint-data-type"></a>


|  Campo  |  Tipo di dati  |  Descrizione  | 
| --- | --- | --- | 
|  EndpointAddress  |  Stringa  |  L’indirizzo dell’endpoint (ad esempio, indirizzo e-mail, numero di telefono).  | 
|  EndpointType  |  Stringa  |  Il tipo di endpoint, ad esempio e-mail predefinita o e-mail aziendale.  | 

## Tipo di dati evento
<a name="event-data-type"></a>


|  Campo  |  Tipo di dati  |  Descrizione  | 
| --- | --- | --- | 
|  UpdatedDate  |  Stringa  |  Il timestamp che indica quando si è verificato l’evento di comunicazione.  | 
|  EventId  |  Stringa  |  L’identificativo univoco per ogni evento di comunicazione.  | 
|  EventType  |  Stringa  |  Il tipo di evento di comunicazione specifico.  | 
|  Attributes  |  Mappa <String, String>  |  Coppia di attributi chiave-valore specifici per il tipo di evento.  | 

# Mappatura degli oggetti Campaign al record di comunicazione standard in Amazon Connect Customer Profiles
<a name="mapping-campaign-objects-to-the-standard-communication-record-in-amazon-connect-customer-profiles"></a>

 Questo argomento elenca i campi degli oggetti Campaign mappati ai campi nell’oggetto record di comunicazione standard in Profili dei clienti. 

## Oggetto Campaign-Email
<a name="campaign-email-object"></a>

 Per un elenco di tutti i campi in un oggetto Campaign-Email, consulta l’[oggetto Email](https://docs.aws.amazon.com/ses/latest/dg/event-publishing-retrieving-sns-contents.html) nella documentazione di Amazon SES. 

**Mappatura di un oggetto Campaign-Email su un record di comunicazione standard**

 Un sottoinsieme dei campi nell’oggetto Campaign-Email viene mappato all’oggetto record di comunicazione standard in Profili dei clienti. 

 La tabella seguente elenca quali campi possono essere mappati dall’oggetto Campaign-Email al record di comunicazione standard. 


|  Campo origine Campaign-Email  |  Campo di destinazione del record di comunicazione standard  | 
| --- | --- | 
|  campaign\$1event\$1id  |  Attributi. LastCampaignEventId  | 
|  outbound\$1request\$1id  |  Attributi. OutboundCampaignRequestId  | 
|  campaign\$1message\$1id  |  Attributi. CampaignMessageId  | 
| channel.name  |  Canale  | 
|  channel.subtype  |  Attributi. ChannelSubType  | 
|  endpoint\$1address  |  Punto finale. EndpointAddress  | 
|  endpoint\$1type  |  Punto finale. EndpointType  | 
|  instance\$1arn  |  ConnectInstanceArn  | 
|  campaign\$1name  |  Campagna. CampaignName  | 
|  campaign\$1id  |  Campagna. CampaignId  | 
|  campaign\$1run\$1id  |  Campagna. CampaignRunId  | 
|  campaign\$1activity\$1id  |  Campagna. CampaignActivityId  | 
|  segment\$1arn  |  Campagna. SegmentArn  | 
|  outbound\$1request\$1creation\$1timestamp  |  CreatedDate  | 
|  campaign\$1event\$1timestamp  |  UpdatedDate  | 
|  campaign\$1event\$1type  |  LastEventType  | 
|  campaign\$1event\$1timestamp  |  Eventi. \$1\$1campaign\$1event\$1type\$1\$1. UpdatedDate  | 
|  campaign\$1event\$1id  |  Eventi. \$1\$1campaign\$1event\$1type\$1\$1. EventId  | 
|  campaign\$1event\$1type  |  Eventi. \$1\$1campaign\$1event\$1type\$1\$1. EventType  | 
|  email.bounce.bounceType  |  Events.Bounce.Attributi. BounceType  | 
|  e-mail.bounce. bounceSubType  |  Events.Bounce.Attributi. BounceSubType  | 
|  email.click.link  |  Events.Click.Attributes.Link  | 
|  email.click.ipAddress  |  Events.Click.Attributi. IpAddress  | 
|  email.open.ipAddress  |  Eventi.Open.Attributi. IpAddress  | 
|  email.reject.reason  |  Events.Reject.Attributes.Reason  | 
|  email.renderingFailure.templateName  |  Eventi. RenderingFailure.Attributi. TemplateName  | 
|  email.renderingFailure.errorMessage  |  Eventi. RenderingFailure.Attributi. ErrorMessage  | 
|  email.deliveryDelay.delayType  |  Eventi. DeliveryDelay.Attributi. DelayType  | 
|  email.reclamo. complaintFeedbackType  |  Events.Complaint.Attributi. ComplaintFeedbackType  | 
|  email.reclamo. complaintSubType  |  Events.Complaint.Attributi. ComplaintSubType  | 
|  email.mail.commonHeaders.subject  |  Attributes.Subject  | 

## Oggetto Campaign-SMS
<a name="campaign-sms-object"></a>

 Per un elenco di tutti i campi in un oggetto Campaign-SMS, consulta l’[oggetto SMS](https://docs.aws.amazon.com/sms-voice/latest/userguide/configuration-sets-event-format.html) nella documentazione del sistema di messaggistica per utenti finali AWS SMS. 

**Mappatura di un oggetto Campaign-SMS su un record di comunicazione standard**

 Un sottoinsieme dei campi nell’oggetto Campaign-SMS viene mappato all’oggetto record di comunicazione standard in Profili dei clienti. 

 La tabella seguente elenca quali campi possono essere mappati dall’oggetto Campaign-SMS al record di comunicazione standard. 


|  Campo sorgente Campaign-SMS  |  Campo di destinazione del record di comunicazione standard  | 
| --- | --- | 
|  campaign\$1event\$1id  |  Attributi. LastCampaignEventId  | 
|  outbound\$1request\$1id  |  Attributi. OutboundCampaignRequestId  | 
|  campaign\$1message\$1id  |  Attributi. CampaignMessageId  | 
| channel.name  |  Canale  | 
|  channel.subtype  |  Attributi. ChannelSubType  | 
|  endpoint\$1address  |  Punto finale. EndpointAddress  | 
|  endpoint\$1type  |  Punto finale. EndpointType  | 
|  instance\$1arn  |  ConnectInstanceArn  | 
|  campaign\$1name  |  Campagna. CampaignName  | 
|  campaign.campaign\$1id  |  Campagna. CampaignId  | 
|  campaign.campaign\$1run\$1id  |  Campagna. CampaignRunId  | 
|  campaign\$1activity\$1id  |  Campagna. CampaignActivityId  | 
|  segment\$1arn  |  Campagna. SegmentArn  | 
|  outbound\$1request\$1creation\$1timestamp  |  CreatedDate  | 
|  campaign\$1event\$1timestamp  |  UpdatedDate  | 
|  campaign\$1event\$1type  |  LastEventType  | 
|  campaign\$1event\$1timestamp  |  Eventi. \$1\$1campaign\$1event\$1type\$1\$1. UpdatedDate  | 
|  campaign\$1event\$1id  |  Eventi. \$1\$1campaign\$1event\$1type\$1\$1. EventId  | 
|  campaign\$1event\$1type  |  Eventi. \$1\$1campaign\$1event\$1type\$1\$1. EventType  | 
|  sms.messageType  |  Eventi. \$1\$1campaign\$1event\$1type\$1\$1 .Attributi. MessageType  | 
|  sms.messageStatus  |  Eventi. \$1\$1campaign\$1event\$1type\$1\$1 .Attributi. MessageStatus  | 
|  sms. messageStatusDescription  |  Eventi. \$1\$1campaign\$1event\$1type\$1\$1 .Attributi. MessageStatusDescription  | 
|  sms. totalMessagePrice  |  Eventi. \$1\$1campaign\$1event\$1type\$1\$1 .Attributi. TotalMessagePrice  | 
|  sms. totalCarrierFee  |  Eventi. \$1\$1campaign\$1event\$1type\$1\$1 .Attributi. TotalCarrierFee  | 
|  sms. isoCountryCode  |  Eventi. \$1\$1campaign\$1event\$1type\$1\$1 .Attributi. IsoCountryCode  | 

## Oggetto Campaign-Telephony
<a name="campaign-telephony-object"></a>

Per un elenco di tutti i campi in un oggetto Campaign-Telephony, consultate l'[oggetto Voice](https://docs.aws.amazon.com/sms-voice/latest/userguide/configuration-sets-event-format.html) nella documentazione SMS di AWS End User Messaging.

**Mappatura di un oggetto Campaign-Telephony su un record di comunicazione standard**

Un sottoinsieme dei campi nell’oggetto Campaign-Telephony viene mappato all’oggetto record di comunicazione standard in Profili dei clienti.

La tabella seguente elenca quali campi possono essere mappati dall’oggetto Campaign-Telephony al record di comunicazione standard.


| Campo origine Campaign-Telephony | Campo di destinazione del record di comunicazione standard | 
| --- | --- | 
| campaign\$1event\$1id | Attributi. LastCampaignEventId | 
| outbound\$1request\$1id | Attributi. OutboundCampaignRequestId | 
| campaign\$1message\$1id | Attributi. CampaignMessageId | 
| channel.name | Canale | 
| channel.subtype | Attributi. ChannelSubType | 
| endpoint.endpoint\$1address | Punto finale. EndpointAddress | 
| endpoint.endpoint\$1type | Punto finale. EndpointType | 
| instance\$1arn | ConnectInstanceArn | 
| campaign.campaign\$1name | Campagna. CampaignName | 
| campaign.campaign\$1id | Campagna. CampaignId | 
| campaign.campaign\$1run\$1id | Campagna. CampaignRunId | 
| campaign.campaign\$1activity\$1id | Campagna. CampaignActivityId | 
| campaign.segment\$1arn | Campagna. SegmentArn | 
| outbound\$1request\$1creation\$1timestamp | CreatedDate | 
| campaign\$1event\$1timestamp | UpdatedDate | 
| campaign\$1event\$1type | LastEventType | 
| campaign\$1event\$1timestamp | Eventi. \$1\$1campaign\$1event\$1type\$1\$1. UpdatedDate | 
| campaign\$1event\$1id | Eventi. \$1\$1campaign\$1event\$1type\$1\$1. EventId | 
| campaign\$1event\$1type | Eventi. \$1\$1campaign\$1event\$1type\$1\$1. EventType | 
| Informazioni su Voice.AgentInfo. connectedToAgentTimestamp | Eventi. \$1\$1campaign\$1event\$1type\$1\$1 .Attributi. ConnectedToAgentTimestamp | 
| voce. customerVoiceActivity. greetingEndTimestamp | Eventi. \$1\$1campaign\$1event\$1type\$1\$1 .Attributi. GreetingEndTimestamp | 
| voce. answeringMachineDetectionstato | Eventi. \$1\$1campaign\$1event\$1type\$1\$1 .Attributi. AnsweringMachineDetectionStatus | 
| campaign\$1event\$1timestamp | SourceLastUpdatedTimestamp | 

## Oggetto Campaign-Orchestration
<a name="campaign-orchestration-object"></a>

**Mappatura di un oggetto Campaign-Orchestration su un record di comunicazione standard**

Un sottoinsieme dei campi nell’oggetto Campaign-Orchestration viene mappato all’oggetto record di comunicazione standard in Profili dei clienti.

La tabella seguente elenca quali campi possono essere mappati dall’oggetto Campaign-Orchestration al record di comunicazione standard.


| Campo origine Campaign-Orchestration | Campo di destinazione del record di comunicazione standard | 
| --- | --- | 
| campaign\$1event\$1id | Attributi. LastCampaignEventId | 
| channel.name | Canale | 
| channel.subtype | Attributi. ChannelSubType | 
| instance\$1arn | ConnectInstanceArn | 
| campaign.campaign\$1name | Campagna. CampaignName | 
| campaign.campaign\$1id | Campagna. CampaignId | 
| campaign.campaign\$1run\$1id | Campagna. CampaignRunId | 
| campaign.campaign\$1activity\$1id | Campagna. CampaignActivityId | 
| campaign.segment\$1arn | Campagna. SegmentArn | 
| campaign\$1event\$1timestamp | UpdatedDate | 
| campaign\$1event\$1type | LastEventType | 
| campaign\$1event\$1timestamp | Eventi. \$1\$1campaign\$1event\$1type\$1\$1. UpdatedDate | 
| campaign\$1event\$1id | Eventi. \$1\$1campaign\$1event\$1type\$1\$1. EventId | 
| campaign\$1event\$1type | Eventi. \$1\$1campaign\$1event\$1type\$1\$1. EventType | 
| campaign\$1event\$1timestamp | SourceLastUpdatedTimestamp | 

## Esempio
<a name="example"></a>

 L’esempio seguente mostra come mappare un campo origine a un campo di destinazione. 

```
"channel": {
    "source": "_source.engagement.channel.name",
    "target": "_communicationRecord.Channel"
}
```

# Mappatura del tipo di oggetto per l’asset standard Profili dei clienti
<a name="object-type-mapping-standard-asset"></a>

Gli argomenti di questa sezione forniscono la definizione standard delle risorse e la mappatura dei tipi di oggetto da applicazioni esterne alla risorsa standard.

**Topics**
+ [Requisiti di AppFlow accesso ad Amazon](appflow-access-requirements-asset.md)
+ [Definizione di risorse standard](standard-asset-definition.md)
+ [Mappatura degli oggetti Salesforce sulla risorsa standard](mapping-salesforce-objects-to-asset.md)

# Requisiti di AppFlow accesso ad Amazon nei profili dei clienti
<a name="appflow-access-requirements-asset"></a>

Utilizza i seguenti requisiti di AppFlow accesso Amazon per creare ed eliminare integrazioni Salesforce con i profili cliente Amazon Connect:
+ `appflow:CreateFlow`
+ `appflow:DeleteFlow`

# Definizione dell’asset standard in Amazon Connect Customer Profiles
<a name="standard-asset-definition"></a>

La tabella seguente elenca tutti i campi dell'oggetto della risorsa standard Profili cliente.


| Campo risorse standard | Tipo di dati | Descrizione | 
| --- | --- | --- | 
|  AssetId  | Stringa  | L'identificatore univoco di una risorsa standard.  | 
|  AssetName  | Stringa  | Il nuovo nome della risorsa.  | 
|  SerialNumber  | Stringa  | Il numero di serie della risorsa.  | 
|  ModelNumber  | Stringa  | Il numero di modello della risorsa.  | 
|  ModelName  | Stringa  | Il nome del modello della risorsa.  | 
|  ProductSKU  | Stringa  | L'unità di gestione delle scorte della risorsa.  | 
|  PurchaseDate  | Stringa  | La data di acquisto della risorsa.  | 
|  UsageEndDate  | Stringa  | Data di fine dell'utilizzo della risorsa.  | 
|  Status  | Stringa  | Lo stato della risorsa.  | 
|  Prezzo  | Stringa  | Il prezzo della risorsa.  | 
|  Quantità  | Stringa  | La quantità della risorsa.  | 
|  Description  | Stringa  | Descrizione della risorsa.  | 
|  AdditionalInformation  | Stringa  | Qualsiasi informazione aggiuntiva pertinente alla risorsa.  | 
|  DataSource  | Stringa  | L'origine dati della risorsa.  | 
|  Attributes  | String-to-string mappa  | Coppia di attributi chiave-valore di una risorsa standard.  | 

Gli oggetti dell’asset standard sono indicizzati in base alle chiavi riportate nella tabella seguente.


| Nome dell’indice standard | Campo risorse standard | 
| --- | --- | 
| \$1assetId | AssetId | 
| \$1assetName | AssetName | 
| \$1serialNumber | SerialNumber | 

Ad esempio, puoi utilizzarlo `_assetName` come nome chiave con l'[SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) per trovare un profilo con una risorsa che AssetName corrisponda al valore di ricerca. Potete trovare gli oggetti asset standard associati a un profilo specifico utilizzando l'[ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) con `ProfileId` and `ObjectTypeName` set to`_asset`.

# Mappatura degli oggetti Salesforce sull’asset standard in Profili dei clienti
<a name="mapping-salesforce-objects-to-asset"></a>

Questo argomento elenca i campi degli oggetti Salesforce mappati ai campi dell'oggetto della risorsa standard in Profili cliente. 

## Oggetto Salesforce-Asset
<a name="salesforceaccountobject-asset"></a>

Di seguito è riportato un elenco di tutti i campi in un oggetto Salesforce-Asset. 
+ Id
+ ContactId
+ AccountId
+ ParentId
+ RootAssetId
+ Product2Id
+ ProductCode
+ IsCompetitorProduct
+ CreatedDate
+ CreatedById
+ LastModifiedDate
+ LastModifiedById
+ SystemModstamp
+ IsDeleted
+ Name
+ SerialNumber
+ InstallDate
+ PurchaseDate
+ UsageEndDate
+ LifecycleStartDate
+ LifecycleEndDate
+ Status
+ Prezzo
+ Quantità
+ Description
+ OwnerId
+ AssetProvidedById
+ AssetServiceById
+ IsInternal
+ AssetLevel
+ StockKeepingUnit
+ HasLifecycleManagement
+ CurrentMrr
+ CurrentLifecycleEndDate
+ CurrentQuantity
+ CurrentAmount
+ LastViewedDate
+ LastReferencedDate

## Mappatura di un oggetto Salesforce-Asset su una risorsa standard
<a name="mapping-salesforceaccountobject"></a>

Un sottoinsieme dei campi dell'oggetto Salesforce-Asset viene mappato all'oggetto della risorsa standard in Profili cliente. 

La tabella seguente elenca quali campi possono essere mappati dall'oggetto Salesforce-Asset alla risorsa standard. 


| Campo di origine Saleforce-Asset | Campo di destinazione della risorsa standard | 
| --- | --- | 
|  Id  | Attributi. sfdcAssetId  | 
|  ContactId  | Attributi. sfdcContactId  | 
|  AccountId  | Attributi. sfdcAccountId  | 
|  SerialNumber  | SerialNumber  | 
|  StockKeepingUnit  | ProductSKU  | 
|  UsageEndDate  | UsageEndDate  | 
|  Status  | Status  | 
|  Prezzo  | Prezzo  | 
|  Quantità  | Quantità  | 
|  Description  | Description  | 

I dati dei clienti Salesforce-Asset dell'oggetto Salesforce sono associati a una risorsa standard Amazon Connect utilizzando gli indici nella tabella seguente. 


| Nome dell'indice standard | Campo di origine Salesforce-Asset | 
| --- | --- | 
|  \$1salesforceAssetId  | Id  | 
|  \$1salesforceContactId  | ContactId  | 
|  \$1salesforceAccountId  | AccountId  | 

Ad esempio, puoi utilizzare `_salesforceAssetId` e `_salesforceAccountId` utilizzare `ObjectFilter.KeyName` l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API per trovare una risorsa standard. Puoi trovare gli oggetti Salesforce-Asset associati a un profilo specifico utilizzando l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API con and set to. `ProfileId` `ObjectTypeName` `Salesforce-Asset` 

# Mappatura del tipo di oggetto per il caso standard in Profili dei clienti
<a name="object-type-mapping-standard-case"></a>

Gli argomenti di questa sezione forniscono la definizione standard dei casi e la mappatura dei tipi di oggetto da applicazioni esterne al caso standard.

**Topics**
+ [Requisiti di AppFlow accesso ad Amazon](appflow-access-requirements-case.md)
+ [Definizione di casi standard](standard-case-definition.md)
+ [Mappatura degli oggetti Zendesk](mapping-zendesk-objects-case.md)
+ [ServiceNow Mappatura degli oggetti](mapping-servicenow-objects-standard-case.md)

# Requisiti di AppFlow accesso ad Amazon nei profili dei clienti
<a name="appflow-access-requirements-case"></a>

Utilizza i seguenti requisiti di AppFlow accesso Amazon per creare ed eliminare Zendesk e ServiceNow le integrazioni con i profili dei clienti Amazon Connect:
+ `appflow:CreateFlow`
+ `appflow:DeleteFlow`

# Campi dell’oggetto del caso standard di Profili dei clienti.
<a name="standard-case-definition"></a>

La tabella seguente elenca tutti i campi dell'oggetto del caso standard di Profili cliente.


| Campo del caso standard | Tipo di dati | Descrizione | 
| --- | --- | --- | 
|  CaseId  | Stringa  | L'identificatore univoco di un caso standard.  | 
|  Titolo  | Stringa  | Il titolo del caso  | 
|  Riepilogo  | Stringa  | Riepilogo del caso.  | 
|  Status  | Stringa  | Lo stato del caso.  | 
|  Motivo  | Stringa  | Il motivo del caso.  | 
|  CreatedBy  | Stringa  | Il creatore del caso.  | 
|  CreatedDate  | Stringa  | La data di creazione del caso.  | 
|  UpdatedDate  | Stringa  | La data di aggiornamento del caso.  | 
|  ClosedDate  | Stringa  | Data di chiusura del caso.  | 
|  AdditionalInformation  | Stringa  | Qualsiasi informazione aggiuntiva pertinente al caso.  | 
|  DataSource  | Stringa  | L'origine dati del caso.  | 
|  Attributes  | String-to-string mappa  | Coppia di attributi chiave-valore di un caso standard.  | 

Gli oggetti del caso standard sono indicizzati in base alle chiavi riportate nella tabella seguente.


| Nome dell’indice standard | Campo del caso standard | 
| --- | --- | 
| \$1caseId | CaseId | 

Ad esempio, puoi utilizzarlo `_caseId` come nome chiave con l'[SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) per trovare un profilo con un maiuscolo/minuscolo che CaseId corrisponda al valore di ricerca. Puoi trovare gli oggetti case standard associati a un profilo specifico utilizzando l'[ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) con `ProfileId` and `ObjectTypeName` set to`_case`.

# Mappatura degli oggetti Zendesk sul caso standard in Amazon Connect Customer Profiles
<a name="mapping-zendesk-objects-case"></a>

Questo argomento elenca i campi degli oggetti Zendesk mappati ai campi nel caso standard di Profili cliente.

## Oggetto Zendesk-Tickets
<a name="zendeskticketsobject"></a>

Di seguito è riportato un elenco di tutti i campi in un oggetto Zendesk-tickets.
+ id
+ url
+ tipo
+ subject
+ raw\$1subject
+ description
+ priority
+ status
+ recipient
+ requester\$1id
+ submitter\$1id
+ assignee\$1id
+ organization\$1id
+ group\$1id
+ collaborator\$1ids
+ email\$1cc\$1ids
+ follower\$1ids
+ forum\$1topic\$1id
+ problem\$1id
+ has\$1incidents
+ due\$1at
+ tag
+ via.channel
+ custom\$1fields
+ satisfaction\$1rating
+ sharing\$1agreement\$1ids
+ followup\$1ids
+ ticket\$1form\$1id
+ brand\$1id
+ allow\$1channelback
+ allow\$1attachments
+ is\$1public
+ created\$1at
+ aggiornato\$1at

## Mappatura dell'oggetto Zendesk-Tickets su un caso standard
<a name="mapping-zendeskticketsobject-case"></a>

Un sottoinsieme dei campi dell'oggetto Zendesk-Tickets viene mappato al caso standard di Profili cliente. La tabella seguente elenca quali campi possono essere mappati dall'oggetto Zendesk-tickets al caso standard.


| Campo di origine Zendesk-tickets | Campo di destinazione del caso standard | 
| --- | --- | 
|  requester\$1id  | Attributi. ZendeskUserId  | 
|  id  | Attributi. ZendeskTicketId  | 
|  subject  | Titolo  | 
|  description  | Riepilogo  | 
|  status  | Status  | 
|  requester\$1id  | CreatedBy  | 
|  created\$1at  | CreatedDate  | 
|  updated\$1at  | UpdatedDate  | 

I dati dei clienti Zendesk-tickets dell'oggetto Zendesk sono associati a un caso standard Amazon Connect utilizzando i seguenti indici. 


| Nome dell'indice standard | Campo di origine Zendesk-tickets | 
| --- | --- | 
|  \$1zendeskUserId  | requester\$1id  | 
|  \$1zendeskTicketId  | id  | 

Ad esempio, puoi utilizzare `_zendeskUserId` e `_zendeskTicketId` `ObjectFilter.KeyName` con l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API per trovare un caso standard. Puoi trovare gli oggetti Zendesk-Tickets associati a un profilo specifico utilizzando l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API con `ProfileId` and `ObjectTypeName` set to. `Zendesk-tickets` 

# Mappatura ServiceNow degli oggetti al case standard nei profili dei clienti di Amazon Connect
<a name="mapping-servicenow-objects-standard-case"></a>

Questo argomento elenca i campi negli ServiceNow oggetti mappati ai campi nel caso standard dei profili dei clienti di Amazon Connect.

## Oggetto Servicenow-task
<a name="servicenow-task-object"></a>

Di seguito è riportato un elenco di tutti i campi in un oggetto Servicenow-task. 
+ sys\$1id
+ attiva
+ activity\$1due
+ additional\$1assignee\$1list
+ approval
+ approval\$1history
+ approval\$1set
+ assigned\$1to
+ assignment\$1group
+ business\$1duration
+ business\$1service
+ calendar\$1duration
+ closed\$1at
+ closed\$1by
+ cmdb\$1ci.display\$1value
+ cmdb\$1ci.link
+ comments
+ comments\$1and\$1work\$1notes
+ company
+ contact\$1type
+ contract
+ correlation\$1display
+ attiva
+ correlation\$1id
+ delivery\$1plan
+ delivery\$1task
+ description
+ due\$1date
+ escalation
+ expected\$1start
+ follow\$1up
+ group\$1list
+ impact
+ knowledge
+ location
+ made\$1sla
+ number
+ opened\$1at
+ opened\$1by.display\$1value
+ order
+ parent
+ priority
+ reassignment\$1count
+ service\$1offering
+ short\$1description
+ sla\$1due
+ stato
+ sys\$1class\$1name
+ sys\$1created\$1by
+ sys\$1created\$1on
+ attiva
+ sys\$1domain.global
+ sys\$1domain.link
+ sys\$1domain\$1path
+ sys\$1mod\$1count
+ sys\$1updated\$1by
+ sys\$1updated\$1on
+ time\$1worked
+ upon\$1approval
+ upon\$1reject
+ urgency
+ user\$1input
+ watch\$1list
+ work\$1end
+ work\$1notes
+ work\$1notes\$1list
+ work\$1start

## Mappatura di Servicenow-task su un caso standard
<a name="mapping-servicenow-task-case"></a>

Un sottoinsieme dei campi dell'oggetto Servicenow-task viene mappato al caso standard in Profili cliente. 

La tabella seguente elenca quali campi possono essere mappati dall'oggetto Servicenow-task al caso standard. 


| Campo di origine Servicenow-task | Campo di destinazione del caso standard | 
| --- | --- | 
|  sys\$1id  | Attributi. ServiceNowTaskId  | 
|  opened\$1by.link  | Attributi. ServiceNowSystemUserId  | 
|  short\$1description  | Titolo  | 
|  description  | Riepilogo  | 
|  status  | Status  | 
|  sys\$1created\$1by  | CreatedBy  | 
|  sys\$1created\$1on  | CreatedDate  | 
|  sys\$1updated\$1on  | UpdatedDate  | 

I dati dei clienti Servicenow-task di Servicenow sono associati a un caso standard di Amazon Connect utilizzando gli indici nella tabella seguente. 


| Nome dell'indice standard | Campo di origine Servicenow-task | 
| --- | --- | 
|  \$1 serviceNowTask Identificazione  | sys\$1id  | 
|  \$1 serviceNowSystem Identificativo  | open\$1by.link  | 

Ad esempio, puoi utilizzare `_serviceNowTaskId` e `_serviceNowSystemId` utilizzare `ObjectFilter.KeyName` l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API per trovare un caso standard. È possibile trovare gli oggetti ServiceNow-Task associati a un profilo specifico utilizzando l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API con and set to. `ProfileId` `ObjectTypeName` `Servicenow-task`

## Oggetto Servicenow-incident
<a name="servicenowincident-object"></a>

Di seguito è riportato un elenco di tutti i campi in un oggetto Servicenow-incident. 
+ sys\$1id
+ business\$1stc
+ calendar\$1stc
+ caller\$1id.link
+ caller\$1id.value
+ category
+ caused\$1by
+ child\$1incidents
+ close\$1code
+ hold\$1reason
+ incident\$1state
+ notify
+ parent\$1incident
+ problem\$1id
+ reopened\$1by
+ reopened\$1time
+ reopen\$1count
+ resolved\$1at
+ resolved\$1by.link
+ resolved\$1by.value
+ rfc
+ severity
+ subcategory

## Mappatura di Servicenow-incident su un caso standard
<a name="mapping-servicenowincident-case"></a>

Un sottoinsieme dei campi dell'oggetto Servicenow-incident viene mappato al caso standard in Profili cliente.

La tabella seguente elenca quali campi possono essere mappati dall'oggetto Servicenow-incident al caso standard. 


| Campo di origine Servicenow-incident | Campo di destinazione del caso standard | 
| --- | --- | 
| sys\$1id  |  Attributi\$1 ServiceNowIncidentId  | 
| caller\$1id.link  |  Attributi\$1 ServiceNowSystemUserId  | 
| incident\$1status  |  Status  | 
| caller\$1id.link  |  CreatedBy  | 
| resolved\$1at  |  ClosedDate  | 
| category  |  Motivo  | 

I dati dei clienti Servicenow-incident relativi all'incidente dell'oggetto Servicenow sono associati a un caso standard di Amazon Connect utilizzando gli indici nella tabella seguente. 


| Nome dell'indice standard | Campo di origine Servicenow | 
| --- | --- | 
| \$1 Id serviceNowIncident  |  sys\$1id  | 
| \$1 serviceNowSystem Identificativo  |  caller\$1id.link  | 

Ad esempio, puoi usare `_serviceNowIncidentId` and `_serviceNowSystemId` come ObjectFilter. KeyName con l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API per trovare un caso standard. È possibile trovare gli oggetti ServiceNow-Incident associati a un profilo specifico utilizzando l'[ListProfileObjects](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html)API con and set to. `ProfileId` `ObjectTypeName` `Servicenow-incident`

# Mappatura del tipo di oggetto per la preferenza di volo standard
<a name="object-type-mapping-standard-air-preference"></a>

Gli argomenti di questa sezione forniscono la definizione standard delle preferenze di volo.

**Topics**
+ [

# Campi dell’oggetto preferenza di volo standard di Profili dei clienti
](standard-air-preference-object-fields.md)

# Campi dell’oggetto preferenza di volo standard di Profili dei clienti
<a name="standard-air-preference-object-fields"></a>

La tabella seguente elenca tutti i campi nell’oggetto preferenza di volo di Profili dei clienti.


**Preferenza di volo**  

| Campo airPreference standard | Tipo di dati | Descrizione | 
| --- | --- | --- | 
| PreferenceId | Stringa | L’identificativo univoco di una preferenza di volo standard | 
| Name | Stringa | Il nome della preferenza | 
| CreatedDate | Stringa | La data in cui è stata creata la preferenza | 
| CreatedBy | Stringa | L’identificativo di chi l’ha creata. | 
| UpdatedDate | Stringa | La data dell’ultimo aggiornamento | 
| UpdatedBy | Stringa | L’identificativo della persona che ha effettuato l’ultimo aggiornamento | 
| StartDate | Stringa | La data di inizio della preferenza | 
| EndDate | Stringa | La data di fine della preferenza | 
| Status | Stringa | Lo stato corrente della preferenza | 
| ReferenceId | Stringa | L’id dell’oggetto a cui si fa riferimento | 
| ReferenceType | Stringa | Il tipo di oggetto a cui si fa riferimento | 
| TravelType | Stringa | Il tipo di viaggio (ad es. voli diretti) | 
| Trasferire | Stringa | Il tipo di trasferimento preferito | 
| ArrivalAirport | Stringa | Aeroporto di arrivo preferito | 
| ArrivalTerminal | Stringa | Il terminal dell’aeroporto di arrivo preferito | 
| DepartureAirport | Stringa | Aeroporto di partenza preferito | 
| DepartureTerminal | Stringa | Il terminal dell’aeroporto di partenza preferito | 
| HomeAirport | Stringa | L’aeroporto di origine | 
| CheckInChannel | Stringa | La modalità di check-in | 
| CheckInChannelDevice | Stringa | Il dispositivo utilizzato per il check-in | 
| Lingua | Lingua | Dettagli sulle lingue preferite per la comunicazione | 
| Seat | Seat | Dettagli sulla selezione dei posti | 
| Viaggio | Viaggio | Preferenze di viaggio | 
| Accessibilità | Accessibilità | Dettagli sulle richieste di accessibilità | 
| Assicurazione | Assicurazione | Dettagli sull’assicurazione | 
| Interessi | Interessi | Dettagli sugli interessi | 
| Fidelizzazione | Fidelizzazione | Dettagli sulla fidelizzazione | 
| Ristorazione | Ristorazione | Preferenze di ristorazione | 
| MediaEntertainment | MediaEntertainment | Preferenze multimediali e di intrattenimento | 
| PaymentForm | PaymentForm | Preferenze del metodo di pagamento | 
| PetInfo | PetInfo | Dettagli sugli animali domestici | 
| SpecialRequest | SpecialRequest | Dettagli delle richieste speciali | 
| TicketDistribution | TicketDistribution | Preferenze di distribuzione dei biglietti | 
| Marketing | Marketing | Preferenze di marketing | 
| Medical | Medical | Preferenze mediche | 
| Bagagli | Bagagli | Preferenze relative al bagaglio | 
| ContactDetail | ContactDetail | Dettagli sul contatto di preferenza | 
| ContactDetailAddress | ContactDetailAddress | Indirizzo per i dati di contatto | 
| ContactDetailCommunication | ContactDetailCommunication | Preferenze di comunicazione | 
| Attributes | Mappa <String, String> | Coppia di attributi chiave-valore di una preferenza di volo | 

Gli oggetti della preferenza di volo sono indicizzati in base alle chiavi riportate nella tabella seguente.


**Campi dell’indice standard**  

| Nome dell’indice standard | Campo di registrazione delle preferenze standard | 
| --- | --- | 
| \$1airPreferenceId | PreferenceId | 
| \$1airReferenceId | ReferenceId | 

Ad esempio, potete utilizzarlo `_airPreferenceId` come nome chiave con l'[SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) per trovare un profilo con una preferenza air che PreferenceId corrisponda al valore di ricerca. Potete trovare gli oggetti AirPreference standard associati a un profilo specifico utilizzando l'[ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) con `ProfileId` and `ObjectTypeName` set to`_airPreference`.


**ContactDetail tipo di dati**  

| Campo airPreference standard | Tipo di dati | Description | 
| --- | --- | --- | 
| Tipo | Stringa | Il tipo di contatto (ad esempio personale, di emergenza) | 
| PreferenceLevel | Stringa | Livello di priorità di questo contatto | 
| PhoneNumber | Stringa | Numero di telefono | 
| Relazione | Stringa | La relazione con il profilo | 
| EmailAddress | Stringa | Indirizzo e-mail | 
| EmailLanguage | Stringa | Lingua preferita per le comunicazioni tramite e-mail con i dettagli di contatto | 
| PhoneLanguage | Stringa | Lingua preferita per le comunicazioni telefoniche con i dettagli di contatto | 


**ContactDetailAddress tipo di dati**  

| Campo airPreference standard | Tipo di dati | Description | 
| --- | --- | --- | 
| Tipo | Stringa | Il tipo di indirizzo del contatto | 
| Address1 | Stringa | La prima riga dell’indirizzo di un contatto. | 
| Address2 | Stringa | La seconda riga dell’indirizzo di un contatto. | 
| Address3 | Stringa | La terza riga dell’indirizzo di un contatto. | 
| Address4 | Stringa | La quarta riga dell’indirizzo di un contatto. | 
| City | Stringa | La città dell’indirizzo di contatto. | 
| Paese | Stringa | Il paese dell’indirizzo di contatto. | 
| County | Stringa | La contea dell’indirizzo di contatto. | 
| PostalCode | Stringa | Il codice postale dell’indirizzo di contatto. | 
| Province | Stringa | La provincia dell’indirizzo di contatto. | 
| Stato | Stringa | Lo stato dell’indirizzo di contatto. | 


**ContactDetailCommunication tipo di dati**  

| Campo airPreference standard | Tipo di dati | Description | 
| --- | --- | --- | 
| Metodo | Stringa | Metodo di comunicazione (ad es. SMS, e-mail) | 
| PreferenceLevel | Stringa | Livello di preferenza per il metodo di comunicazione | 


**Tipo di dati linguistici**  

| Campo airPreference standard | Tipo di dati | Descrizione | 
| --- | --- | --- | 
| PhoneLanguage | Stringa | Lingua preferita per le comunicazioni telefoniche | 
| EmailLanguage | Stringa | Lingua preferita per le comunicazioni tramite e-mail | 
| InPersonLanguage | Stringa | Lingua preferita per la comunicazione di persona | 
| PreferenceLevel | Stringa | Livello di preferenza linguistica | 


**Tipo di dati del posto**  

| Campo airPreference standard | Tipo di dati | Descrizione | 
| --- | --- | --- | 
| PreferenceLevel | Stringa | Priorità delle preferenze relative ai posti | 
| Direzione | Stringa | La direzione preferita del posto (ad esempio, anteriore, posteriore) | 
| Location (Ubicazione) | Stringa | La posizione preferita del posto (ad esempio, finestrino, corridoio) | 
| Position | Stringa | La posizione del posto (ad esempio, sinistra, destra) | 
| Riga | Stringa | La fila di posti desiderata | 
| ClassOfService | Stringa | La classe di viaggio (ad es. Economy, Business) | 
| NeighborFree | Stringa | Preferenza per un posto senza vicini | 
| Neonato | Stringa | Preferenza per il seggiolino per neonati | 
| ExtraSeat | Stringa | Preferenza per un posto extra | 


**Tipo di dati del percorso**  

| Campo airPreference standard | Tipo di dati | Descrizione | 
| --- | --- | --- | 
| MaxConnections | Stringa | Numero massimo di connessioni consentite | 
| PreferredAirline | Stringa | Linea aerea preferita | 
| UpgradeAuction | Stringa | Adesione alle aste di upgrade | 
| FlightTime | Stringa | Orario di volo preferito | 
| FlightMaxDuration | Stringa | Durata massima del viaggio preferita | 


**Tipo di dati di accessibilità**  

| Campo airPreference standard | Tipo di dati | Description | 
| --- | --- | --- | 
| Sedia a rotelle | Stringa | Informazioni sull’accessibilità delle sedie a rotelle | 
| Bagno | Stringa | Informazioni sull’accessibilità del bagno | 
| Assistenza | Stringa | Informazioni sull’assistenza | 
| DisabilityType | Stringa | Informazioni sulla disabilità | 
| SupportAnimal | Stringa | Informazioni sugli animali di supporto | 
| ProximityToFacilities | Stringa | Richiede la vicinanza alle strutture | 


**Tipo di dati assicurativi**  

| Campo airPreference standard | Tipo di dati | Description | 
| --- | --- | --- | 
| Nome | Stringa | Nome del fornitore di assicurazioni o del piano | 
| PreferenceLevel | Stringa | Livello di preferenza per l’assicurazione | 


**Tipo di dati sugli interessi**  

| Campo airPreference standard | Tipo di dati | Description | 
| --- | --- | --- | 
| Nome | Stringa | Area di interesse specifica | 
| PreferenceLevel | Stringa | Priorità di questo interesse | 


**Tipo di dati della fidelizzazione**  

| Campo airPreference standard | Tipo di dati | Description | 
| --- | --- | --- | 
| Nome | Stringa | Nome del programma di fidelizzazione | 
| MembershipId | Stringa | ID di iscrizione al programma di fidelizzazione | 
| PreferenceLevel | Stringa | Livello di preferenza del programma di fidelizzazione | 


**Tipo di dati della ristorazione**  

| Campo airPreference standard | Tipo di dati | Descrizione | 
| --- | --- | --- | 
| MealType | Stringa | Tipo di pasto preferito | 
| FavoriteCuisine | Stringa | Tipi di cucina preferiti | 
| Bevande | Stringa | Bevande preferite | 
| DietaryRestriction | Stringa | Restrizioni dietetiche | 
| AllergyInfo | Stringa | Dettagli sulle allergie | 
| PreferenceLevel | Stringa | Livello di preferenza della ristorazione | 


**Tipo di dati multimediali e di intrattenimento**  

| Campo airPreference standard | Tipo di dati | Description | 
| --- | --- | --- | 
| Nome | Stringa | Nome dell’intrattenimento preferito | 
| PreferenceLevel | Stringa | Livello di preferenza per i media e l’intrattenimento | 


**PaymentForm tipo di dati**  

| Campo airPreference standard | Tipo di dati | Description | 
| --- | --- | --- | 
| Nome | Stringa | Nome del metodo di pagamento | 
| Tipo | Stringa | Tipo di pagamento (ad es. carta di credito, PayPal) | 
| PreferenceLevel | Stringa | Livello di preferenza per il metodo di pagamento | 
| UsageContext | Stringa | Dove viene utilizzato il metodo di pagamento | 


**PetInfo tipo di dati**  

| Campo airPreference standard | Tipo di dati | Description | 
| --- | --- | --- | 
| Tipo | Stringa | Tipo di animale domestico | 
| PreferenceLevel | Stringa | Livello di preferenza per gli animali domestici | 


**SpecialRequest tipo di dati**  

| Campo airPreference standard | Tipo di dati | Description | 
| --- | --- | --- | 
| Tipo | Stringa | Tipo di richiesta speciale | 
| Name | Stringa | Nome o descrizione della richiesta | 
| PreferenceLevel | Stringa | Livello di priorità della richiesta | 


**TicketDistribution tipo di dati**  

| Campo airPreference standard | Tipo di dati | Descrizione | 
| --- | --- | --- | 
| PreferenceLevel | Stringa | Livello di preferenza per la distribuzione dei biglietti | 
| Metodo | Stringa | Metodo di consegna del biglietto (ad es. e-mail, cartaceo) | 
| TicketTime | Stringa | Orario preferito per la consegna dei biglietti | 


**Tipo di dati di marketing**  

| Campo airPreference standard | Tipo di dati | Descrizione | 
| --- | --- | --- | 
| ChannelType | Stringa | Tipo di canale di marketing (ad es. SMS, e-mail) | 
| OptIn | Stringa | Stato di adesione per il marketing | 
| Frequenza | Stringa | Frequenza delle comunicazioni di marketing | 
| StartDate | Stringa | Data di inizio della preferenza di marketing | 
| EndDate | Stringa | Data di fine della preferenza di marketing | 


**Tipo di dati medici**  

| Campo airPreference standard | Tipo di dati | Description | 
| --- | --- | --- | 
| Ossigeno | Stringa | (Fornito dalla compagnia aerea, di proprietà del passeggero, concentratore, ecc.) | 
| MedicalEquipment | Stringa | Dettagli sulle apparecchiature mediche (ad es. macchina CPAP, concentratore di ossigeno). | 
| Assistenza | Stringa | Indica se il viaggiatore necessita di assistenza medica generale durante il viaggio (ad esempio, supporto in volo, aiuto con i farmaci). | 
| Barella | Stringa | Se il viaggiatore necessita di una barella durante il volo, in genere utilizzata per casi di trasporto medico. | 
| WheelChair | Stringa | Dati relativi alla sedia a rotelle (dispositivo antiscivolo, cellulare umido, dispositivo di assistenza alle scale RampNeeded, fornito dalla compagnia aerea, ecc.) | 


**Tipo di dati del bagaglio**  

| Campo airPreference standard | Tipo di dati | Description | 
| --- | --- | --- | 
| Animale | Stringa | Indica se il viaggiatore viaggia con un animale di servizio o un animale domestico e include le specifiche o le restrizioni pertinenti (inHold, Cabina). | 
| BaggageType | Stringa | Indica il tipo di gestione del bagaglio preferito (ad esempio, solo bagaglio a mano, bagaglio registrato, bagaglio fuori misura). | 
| Assistenza | Stringa | Indica se il viaggiatore necessita di assistenza per il trasporto o la gestione del bagaglio, ad esempio servizi di portineria in aeroporto o assistenza bagagli a bordo strada. | 
| PreferenceLevel | Stringa | Livello di preferenza per i campi Bagagli | 

# Mappatura del tipo di oggetto per la preferenza alberghiera standard
<a name="object-type-mapping-standard-hotel-preference"></a>

Gli argomenti di questa sezione forniscono la definizione standard delle preferenze alberghiere.

**Topics**
+ [

# Campi dell’oggetto preferenza alberghiera standard di Profili dei clienti.
](standard-hotel-preference-object-fields.md)

# Campi dell’oggetto preferenza alberghiera standard di Profili dei clienti.
<a name="standard-hotel-preference-object-fields"></a>

La tabella seguente elenca tutti i campi nell’oggetto preferenza alberghiera standard di Profili dei clienti.


**Preferenza alberghiera**  

| Campo hotelPreference standard | Tipo di dati | Descrizione | 
| --- | --- | --- | 
| PreferenceId | Stringa | Identificatore univoco di una preferenza alberghiera standard | 
| Name | Stringa | Il nome della preferenza | 
| CreatedDate | Stringa | La data di creazione della preferenza | 
| CreatedBy | Stringa | L’identificativo di chi l’ha creata. | 
| UpdatedDate | Stringa | La data dell’ultimo aggiornamento | 
| UpdatedBy | Stringa | L’identificativo della persona che ha effettuato l’ultimo aggiornamento | 
| StartDate | Stringa | La data di inizio della preferenza | 
| EndDate | Stringa | La data di fine della preferenza | 
| Status | Stringa | Lo stato corrente della preferenza | 
| Fumare | Stringa | Preferenze per fumatori | 
| CleaningTime | Stringa | Orario della pulizia | 
| CheckInType | Stringa | Tipo di check-in | 
| CheckOutType | Stringa | Tipo di check-out | 
| ReferenceId | Stringa | L’id dell’oggetto a cui si fa riferimento | 
| ReferenceType | Stringa | Il tipo di oggetto a cui si fa riferimento | 
| Location (Ubicazione) | Location (Ubicazione) | Preferenze sulla posizione delle camere d’albergo | 
| Biancheria da letto | Biancheria da letto | Preferenze della biancheria da letto | 
| Tour  | Tour  | Preferenze del tour | 
| ContactDetail | ContactDetail | Dettagli sul contatto di preferenza | 
| ContactDetailAddress | ContactDetailAddress | Indirizzo per i dati di contatto | 
| ContactDetailCommunication | ContactDetailCommunication | Preferenze di comunicazione | 
| Lingua | Lingua | Preferenze linguistiche | 
| CarRental | CarRental | Preferenze di autonoleggio | 
| Accessibilità | Accessibilità | Preferenze di accessibilità | 
| Interessi | Interessi | Dettagli sugli interessi | 
| Fidelizzazione | Fidelizzazione | Preferenze di fidelizzazione | 
| Ristorazione | Ristorazione | Preferenze di ristorazione | 
| MediaEntertainment | MediaEntertainment | Preferenze multimediali e di intrattenimento | 
| PaymentForm | PaymentForm | Preferenze della modalità di pagamento | 
| PetInfo | PetInfo | Preferenze relative alle informazioni sugli animali | 
| SpecialRequest | SpecialRequest | Dettagli sulle richieste speciali | 
| Marketing | Marketing | Preferenze di marketing | 
| Medical | Medical | Preferenze mediche | 
| Bagagli | Bagagli | Preferenze bagaglio | 
| Attributes | Mappa <String, String> | Coppia di attributi chiave-valore di una preferenza alberghiera | 

Gli oggetti della preferenza alberghiera sono indicizzati in base alle chiavi riportate nella tabella seguente.


**Campi dell’indice standard**  

| Nome dell’indice standard | Campo di registrazione delle preferenze standard | 
| --- | --- | 
| \$1hotelPreferenceId | PreferenceId | 
| \$1hotelReferenceId | ReferenceId | 

Ad esempio, puoi utilizzarlo `_hotelPreferenceId` come nome chiave con l'[SearchProfiles API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_SearchProfiles.html) per trovare un profilo con una preferenza alberghiera che corrisponda al valore di ricerca. PreferenceId È possibile trovare gli oggetti HotelPreference standard associati a un profilo specifico utilizzando l'[ListProfileObjects API](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjects.html) con `ProfileId` and `ObjectTypeName` set to`_hotelPreference`.


**ContactDetail tipo di dati**  

| Campo airPreference standard | Tipo di dati | Description | 
| --- | --- | --- | 
| Tipo | Stringa | Il tipo di contatto (ad esempio personale, di emergenza) | 
| PreferenceLevel | Stringa | Livello di priorità di questo contatto | 
| PhoneNumber | Stringa | Numero di telefono | 
| Relazione | Stringa | La relazione con il profilo | 
| EmailAddress | Stringa | Indirizzo e-mail | 
| EmailLanguage | Stringa | Lingua preferita per le comunicazioni tramite e-mail con i dettagli di contatto | 
| PhoneLanguage | Stringa | Lingua preferita per le comunicazioni telefoniche con i dettagli di contatto | 


**ContactDetailAddress tipo di dati**  

| Campo airPreference standard | Tipo di dati | Description | 
| --- | --- | --- | 
| Tipo | Stringa | Il tipo di indirizzo del contatto | 
| Address1 | Stringa | La prima riga dell’indirizzo di un contatto. | 
| Address2 | Stringa | La seconda riga dell’indirizzo di un contatto. | 
| Address3 | Stringa | La terza riga dell’indirizzo di un contatto. | 
| Address4 | Stringa | La quarta riga dell’indirizzo di un contatto. | 
| City | Stringa | La città dell’indirizzo di contatto. | 
| Paese | Stringa | Il paese dell’indirizzo di contatto. | 
| County | Stringa | La contea dell’indirizzo di contatto. | 
| PostalCode | Stringa | Il codice postale dell’indirizzo di contatto. | 
| Province | Stringa | La provincia dell’indirizzo di contatto. | 
| Stato | Stringa | Lo stato dell’indirizzo di contatto. | 


**ContactDetailCommunication tipo di dati**  

| Campo hotelPreference standard | Tipo | Description | 
| --- | --- | --- | 
| Metodo | Stringa | Metodo di comunicazione | 
| PreferenceLevel | Stringa | Livello di preferenza per il metodo di comunicazione | 
| Frequenza | Stringa | Frequenza di comunicazione | 


**Tipo di dati linguistici**  

| Campo hotelPreference standard | Tipo | Description | 
| --- | --- | --- | 
| PhoneLanguage | Stringa | Lingua preferita del telefono | 
| EmailLanguage | Stringa | Lingua preferita per le e-mail | 


**CarRental tipo di dati**  

| Campo hotelPreference standard | Tipo | Description | 
| --- | --- | --- | 
| Fornitori | Stringa | Fornitore di autonoleggio preferito | 
| VehicleType | Stringa | Tipo di veicolo preferito | 
| PreferenceLevel | Stringa | Livello di preferenza per il noleggio auto | 


**Tipo di dati sulla posizione**  

| Campo hotelPreference standard | Tipo | Description | 
| --- | --- | --- | 
| PreferredFloor | Stringa | Preferenza per il pavimento della stanza | 
| ElevatorProximity | Stringa | Preferenza per la vicinanza agli ascensori | 
| QuietZone | Stringa | Preferenza per la zona tranquilla | 
| LobbyProximity | Stringa | Preferenza per la vicinanza alla lobby | 
| Vista | Stringa | Vista desiderata dalla stanza | 
| RoomType | Stringa | Tipo di camera preferito | 
| PreferenceLevel | Stringa | Livello di preferenza per la posizione | 


**Tipo di dati della biancheria da letto**  

| Campo hotelPreference standard | Tipo | Description | 
| --- | --- | --- | 
| BedType | Stringa | Tipo di letto preferito | 
| MattressType | Stringa | Tipo di materasso preferito | 
| PillowType | Stringa | Tipo di cuscino preferito | 
| NumberOfPillows | Stringa | Numero di cuscini preferito | 
| BeddingMaterial | Stringa | Materiale della biancheria da letto | 
| Allergia | Stringa | Preferenze relative alla biancheria da letto legate alle allergie | 


**Tipo di dati del tour**  

| Campo hotelPreference standard | Tipo | Description | 
| --- | --- | --- | 
| City | Stringa | Città preferite per i tour | 
| Culturale | Stringa | Interessi per i tour culturali | 
| Avventura | Stringa | interessi per i tour d'avventura | 
| Vita notturna | Stringa | Interessi per i tour della vita notturna | 
| GuideLanguage | Stringa | Lingua preferita per la guida turistica | 
| StartTime | Stringa | Orario di inizio preferito per i tour | 
| GroupSize | Stringa | Dimensione preferita del gruppo per i tour | 
| PreferenceLevel | Stringa | Importanza delle preferenze del tour | 


**Tipi di dati di accessibilità**  

| Campo airPreference standard | Tipo di dati | Description | 
| --- | --- | --- | 
| Sedia a rotelle | Stringa | Informazioni sull’accessibilità delle sedie a rotelle | 
| Bagno | Stringa | Informazioni sull’accessibilità del bagno | 
| Assistenza | Stringa | Informazioni sull’assistenza | 
| DisabilityType | Stringa | Informazioni sulla disabilità | 
| SupportAnimal | Stringa | Informazioni sugli animali di supporto | 
| ProximityToFacilities | Stringa | Richiede la vicinanza alle strutture | 


**Tipo di dati sugli interessi**  

| Campo hotelPreference standard | Tipo | Description | 
| --- | --- | --- | 
| NameOfInterest | Stringa | Nome dell’interesse | 
| PreferenceLevel | Stringa | Livello di preferenza per l’interesse | 


**Tipo di dati della fidelizzazione**  

| Campo hotelPreference standard | Tipo | Description | 
| --- | --- | --- | 
| LoyaltyName | Stringa | Nome del programma di fidelizzazione | 
| MembershipId | Stringa | ID dell’iscrizione al programma di fidelizzazione | 
| PreferenceLevel | Stringa | Livello di preferenza di fidelizzazione | 
| PriorityServices | Stringa | Preferenze per i servizi prioritari | 


**Tipo di dati della ristorazione**  

| Campo hotelPreference standard | Tipo | Description | 
| --- | --- | --- | 
| MealType | Stringa | Tipi di pasti preferiti | 
| FavoriteCuisine | Stringa | Preferenze di cucina preferite | 
| Bevande | Stringa | Preferenze in termini di bevande | 
| DietaryRestriction | Stringa | Restrizioni dietetiche | 
| AllergyInfo | Stringa | Informazioni sulle allergie | 
| PreferenceLevel | Stringa | Livello di preferenza della ristorazione | 


**MediaEntertainment tipo di dati**  

| Campo hotelPreference standard | Tipo | Description | 
| --- | --- | --- | 
| Nome | Stringa | Nome del file multimediale o di intrattenimento preferito | 
| PreferenceLevel | Stringa | Livello di preferenza per contenuti multimediali o di intrattenimento | 


**PaymentForm tipo di dati**  

| Campo hotelPreference standard | Tipo | Description | 
| --- | --- | --- | 
| Nome | Stringa | Nome associato al metodo di pagamento | 
| Tipo | Stringa | Tipo del metodo di pagamento | 
| PreferenceLevel | Stringa | Livello di preferenza per il metodo di pagamento | 
| UsageContext | Stringa | Contesto in cui viene utilizzato il metodo di pagamento | 


**PetInfo tipo di dati**  

| Campo hotelPreference standard | Tipo | Description | 
| --- | --- | --- | 
| Tipo | Stringa | Tipo di animale domestico | 
| PreferenceLevel | Stringa | livello di preferenza per l’animale domestico | 


**Tipo di dati della richiesta speciale**  

| Campo hotelPreference standard | Tipo | Description | 
| --- | --- | --- | 
| Tipo | Stringa | Tipo di richiesta speciale | 
| Name | Stringa | Nome della richiesta speciale | 
| PreferenceLevel | Stringa | Livello di preferenza della richiesta | 


**Tipo di dati di marketing**  

| Campo hotelPreference standard | Tipo | Description | 
| --- | --- | --- | 
| ChannelType | Stringa | Tipo di canale di marketing (ad es. SMS, e-mail) | 
| OptIn | Stringa | Stato di adesione per il marketing | 
| Frequenza | Stringa | Frequenza delle comunicazioni di marketing | 
| StartDate | Stringa | Data di inizio della preferenza di marketing | 
| EndDate | Stringa | Data di fine della preferenza di marketing | 


**Tipo di dati medici**  

| Campo hotelPreference standard | Tipo | Description | 
| --- | --- | --- | 
| Ossigeno | Stringa | Preferenze per la somministrazione di ossigeno | 
| MedicalEquipment | Stringa | Dettagli sulle apparecchiature mediche | 
| Assistenza | Stringa | Tipo di assistenza medica richiesta | 
| Barella | Stringa | Requisiti per ospiti in barella | 
| WheelChair | Stringa | Tipo di sedia a rotelle e assistenza necessari | 


**Tipo di dati del bagaglio**  

| Campo hotelPreference standard | Tipo | Description | 
| --- | --- | --- | 
| Bicicletta | Stringa | Esigenze per bicicletta come bagaglio | 
| BaggageType | Stringa | Dettagli sul bagaglio (ad es. ingombrante) | 
| Corriere | Stringa | Preferenza sul bagaglio relativa al corriere | 
| Fragile | Stringa | Preferenze oggetti fragili | 
| Livello di preferenza | Stringa | Livello di preferenza del bagaglio | 

# Mappatura del tipo di oggetto per la prenotazione aerea
<a name="object-type-mapping-standard-air-booking"></a>

Gli argomenti contenuti in questa sezione forniscono la definizione standard di prenotazione aerea.

**Topics**
+ [

# Campi dell’oggetto prenotazione aerea standard di Profili dei clienti
](standard-air-booking-object-fields.md)

# Campi dell’oggetto prenotazione aerea standard di Profili dei clienti
<a name="standard-air-booking-object-fields"></a>

La tabella seguente elenca tutti i campi nell’oggetto prenotazione aerea standard di Profili dei clienti.


**AirBooking**  

| Campo airBooking standard | Tipo | Description | 
| --- | --- | --- | 
| BookingId | Stringa | L’identificativo univoco della prenotazione aerea standard | 
| ContextId | Stringa | L’identificativo specifico del contesto per tracciare l’origine della prenotazione | 
| PreferenceRef | Stringa | L’identificativo che fa riferimento all’oggetto Preference per la prenotazione | 
| BookingName | Stringa | Il nome associato alla prenotazione | 
| PassengerIndex | Stringa | Indice dei passeggeri inclusi nella prenotazione | 
| TravellerId | Stringa | Identificatore univoco del viaggiatore associato alla prenotazione | 
| GroupBooking | Stringa | Indica se la prenotazione è per un gruppo | 
| NumberOfPassengers | Stringa | Numero totale di passeggeri inclusi nella prenotazione | 
| NumberOfAdults | Stringa | Numero totale di adulti nella prenotazione | 
| NumberOfChildren | Stringa | Numero totale di bambini nella prenotazione | 
| ProcessedDate | Stringa | Data di elaborazione della prenotazione | 
| CreatedDate | Stringa | Data di creazione della prenotazione | 
| CreatedBy | Stringa | Identità del di chi ha creato la prenotazione | 
| UpdatedDate | Stringa | Data dell’ultimo aggiornamento | 
| UpdatedBy | Stringa | Identificativo dell’ultimo aggiornamento della prenotazione | 
| Status | Stringa | Stato corrente della prenotazione | 
| PriorityStatus | Stringa | Livello di priorità della prenotazione | 
| ReservationStatus | Stringa | Stato di riserva della prenotazione | 
| MarketingCode | Stringa | Codice che rappresenta l’origine o la campagna di marketing | 
| MarketingName | Stringa | Nome della campagna di marketing | 
| TravelAgent | Stringa | Agente di viaggio associato alla prenotazione | 
| TravelAgency | Stringa | Nome dell’agenzia di viaggi aziendale | 
| TravelCorpNumber | Stringa | Codice cliente aziendale | 
| Persona che ha effettuato la prenotazione | Stringa | Indica se la persona è quella che ha effettuato la prenotazione | 
| AdditionalInformation | Stringa | Ulteriori informazioni in formato libero | 
| Email | Stringa | E-mail di contatto per gli aggiornamenti relativi al giorno del viaggio | 
| PhoneNumber | Stringa | Telefono di contatto per gli aggiornamenti relativi al giorno del viaggio | 
| CancelledDate | Stringa | Data di cancellazione della prenotazione (se applicabile) | 
| Diplomatico | Stringa | Indica lo stato diplomatico | 
| Figlio | Stringa | Indica se il passeggero è un bambino | 
| Disabilitato | Stringa | Indica lo stato di disabilità | 
| Ossigeno | Stringa | Indica la necessità di un supporto di ossigeno | 
| PetOnly | Stringa | La prenotazione è valida solo per il trasporto di animali domestici | 
| CancellationCharge | Stringa | Costo di cancellazione, se applicabile. 0 significa nessun addebito | 
| Rimborsabile | Stringa | Dettagli sul rimborso della prenotazione | 
|  Inventory |  Inventory | Dettagli dell’inventario per la prenotazione | 
| Fidelizzazione | Fidelizzazione | Dettagli relativi al programma di fidelizzazione per la prenotazione | 
| Canale | Canale | Dettagli del canale per la prenotazione | 
| Pagamento | Pagamento | Dettagli di pagamento per la prenotazione | 
| BillingAddress | Indirizzo | Dettagli dell’indirizzo di fatturazione per la prenotazione | 
| Prezzo | Prezzo | Dettagli sul prezzo della prenotazione | 
| PaymentStatus | PaymentStatus | Stato del pagamento della prenotazione | 
| Attributes | Mappa <String, String> | Attributi personalizzati o di estensione | 


**Campi dell’indice standard**  

| Nome dell’indice standard | Campo di registrazione delle preferenze standard | 
| --- | --- | 
| \$1airBookingId | BookingId | 
| \$1airPreferenceRef | PreferenceRef | 


**Tipo di dati della fidelizzazione**  

| Campo airBooking standard | Tipo | Description | 
| --- | --- | --- | 
| ProgramName | Stringa | Nome del programma di fidelizzazione | 
| MembershipId | Stringa | Numero di iscrizione al programma di fidelizzazione | 
| Livello | Stringa | Livello di iscrizione al programma di fidelizzazione | 


**Tipo di dati del canale**  

| Campo airBooking standard | Tipo | Description | 
| --- | --- | --- | 
| CreationChannelId | Stringa | ID del canale utilizzato per creare la prenotazione | 
| LastUpdatedChannelId | Stringa | ID del canale utilizzato per aggiornare la prenotazione | 
| Metodo | Stringa | Metodo utilizzato tramite il canale (ad es. web, app, telefono) | 


**Tipo di dati del pagamento**  

| Campo airBooking standard | Tipo | Description | 
| --- | --- | --- | 
| Tipo | Stringa | Tipo di metodo di pagamento (ad es. carta, voucher) | 
| CreditCardToken | Stringa | Carta tokenizzata per un riferimento sicuro | 
| CreditCardType | Stringa | Tipo di carta di credito utilizzata | 
| CreditCardExpiration | Stringa | Data di scadenza della carta | 
| Cvv | Stringa | Numero CVV | 
| NameOnCreditCard | Stringa | Nome del titolare della carta | 
| RoutingNumber | Stringa | Codice di avviamento bancario (se applicabile) | 
| AccountNumber | Stringa | Numero di conto bancario (se applicabile) | 
| VoucherId | Stringa | Voucher utilizzato per il pagamento | 
| DiscountCode | Stringa | Codice sconto promozionale applicato | 
| DiscountPercent | Stringa | Percentuale di sconto applicata al pagamento | 


**Tipo di dati dell’indirizzo di fatturazione**  

| Campo airPreference standard | Tipo di dati | Description | 
| --- | --- | --- | 
| Address1 | Stringa | La prima riga dell'indirizzo di un cliente. | 
| Address2 | Stringa | La seconda riga dell'indirizzo di un cliente. | 
| Address3 | Stringa | La terza riga dell'indirizzo di un cliente. | 
| Address4 | Stringa | La quarta riga dell'indirizzo di un cliente. | 
| City | Stringa | La città dell’indirizzo del cliente. | 
| Paese | Stringa | Il paese dell’indirizzo del cliente. | 
| County | Stringa | La contea dell’indirizzo del cliente. | 
| PostalCode | Stringa | Il codice postale dell'indirizzo del cliente. | 
| Province | Stringa | La provincia dell’indirizzo del cliente. | 
| Stato | Stringa | Lo stato dell’indirizzo del cliente. | 


**Tipo di dati sui prezzi**  

| Campo airBooking standard | Tipo | Description | 
| --- | --- | --- | 
| TotalPrice | Stringa | Prezzo totale della prenotazione | 
| BasePrice | Stringa | Prezzo base della prenotazione | 
| TravellerPrice | Stringa | Prezzo pagato per viaggiatore | 
| DiscountAmount | Stringa | Sconto applicato alla tariffa base | 
| Valuta | Stringa | Valuta in cui è stato effettuato il pagamento | 


**Tipo di dati sullo stato del pagamento**  

| Campo airBooking standard | Tipo | Description | 
| --- | --- | --- | 
| PaidAt | Stringa | Timestamp in cui il pagamento è stato completato | 
| AwaitingPayment | Stringa | Indica che il pagamento è in sospeso | 
| RequiredBy | Stringa | Data di scadenza del pagamento | 


**Tipo di dati di inventario**  

| Campo airBooking standard | Tipo | Description | 
| --- | --- | --- | 
| Posti | Stringa | Numero totale dei posti nella prenotazione | 

# Mappatura del tipo di oggetto per il segmento di volo standard
<a name="object-type-mapping-standard-air-segment"></a>

Gli argomenti contenuti in questa sezione forniscono la definizione standard del segmento di volo.

**Topics**
+ [

# Campi dell’oggetto segmento di volo standard di Profili dei clienti
](standard-air-segment-object-fields.md)

# Campi dell’oggetto segmento di volo standard di Profili dei clienti
<a name="standard-air-segment-object-fields"></a>

La tabella seguente elenca tutti i campi nell’oggetto segmento di volo di Profili dei clienti.


**Segmento di volo**  

| Campo airSegment standard | Tipo | Description | 
| --- | --- | --- | 
| SegmentId | Stringa | Identificatore univoco del segmento di volo standard | 
| BookingRef | Stringa | Identificativo di riferimento della prenotazione | 
| SegmentName | Stringa | Nome/descrizione del segmento | 
| PassengerIndex | Stringa | Numero indice del passeggero | 
| SegmentIndex | Stringa | Numero indice del segmento | 
| SeatSelection | Stringa | Dettaglio della selezione del posto | 
| NumberOfPassengers | Stringa | Numero totale di passeggeri | 
| NumberOfLegs | Stringa | Numero di segmenti di volo | 
| Livello | Stringa |  tier/status Livello passeggeri | 
| Origin | Stringa | Codice dell’aeroporto di partenza | 
| OriginCountryCode | Stringa | Codice del paese di partenza | 
| Dest | Stringa | Codice dell’aeroporto di destinazione | 
| DestCountryCode | Stringa | Codice del paese di destinazione | 
| ProcessedDate | Stringa | Data di elaborazione del segmento | 
| CreatedDate | Stringa | Data in cui il record è stato creato | 
| CreatedBy | Stringa | Utente che ha creato il record | 
| UpdatedDate | Stringa | Data dell’ultimo aggiornamento del record | 
| UpdatedBy | Stringa | Utente che ha aggiornato per ultimo il record | 
| Status | Stringa | Stato corrente del segmento | 
| FlightNumber | Stringa | Numero del volo | 
| Carrier (Vettore) | Stringa | Codice operatore operativo | 
| CarrierType | Stringa | Tipo di operatore | 
| IsInternational | Stringa | Indica se il volo è internazionale | 
| IsEticket | Stringa | Indica se è un biglietto elettronico | 
| IsArmed | Stringa | Indica se un passeggero è armato | 
| LapInfant | Stringa | Dettagli del bambino in grembo | 
| Animale domestico | Stringa | Indica se si viaggia con un animale domestico | 
| PrisonerOrGuard | Stringa | Indica lo stato di prigioniero o guardia | 
| Figlio | Stringa | Indica se il passeggero è un bambino | 
| Sposato/a | Stringa | Indica se i segmenti sono sposati | 
| CheckinEligible | Stringa | Indica l’idoneità al check-in | 
| InEligibleReason | Stringa | Motivo per cui non è idoneo al check-in | 
| UnEscortedMinor | Stringa | Indica lo stato di minore non accompagnato | 
| PremiumAccess | Stringa | Indica l’acquisto di un accesso premium | 
| MissingData | Stringa | Indica i dati mancanti | 
| CurrentClassOfService | Stringa | Classe di servizio attuale | 
| BookedClassOfService | Stringa | Classe di servizio prenotata originariamente | 
| CodeShare | Stringa | Indica un volo in codeshare | 
| ReverseCodeShare | Stringa | Indica un codeshare inverso | 
| MarketCarrierCode | Stringa | Codice dell’operatore di marketing | 
| OpCarrierCode | Stringa | Codice operatore operativo | 
| InConnection | Stringa | Dettagli di connessione in entrata | 
| OutConnection | Stringa | Dettagli di connessione in uscita | 
| MilesToEarn | Stringa | Miglia da accumulare | 
| Durata | Stringa | Durata del volo | 
| DurationTimeUnit | Stringa | Unità di tempo per la durata | 
| Distance | Stringa | Distanza del volo | 
| DistanceUnit | Stringa | Unità per la misurazione della distanza | 
| SellType | Stringa | Indica se si tratta di una vendita forzata | 
| GoShow | Stringa | Indica se si tratta di un go show | 
| Inabile | Stringa | Indica se il passeggero è inabile | 
| Upgrade | Stringa | Indica se il volo è passato alla classe superiore | 
| Downgrade | Stringa | Indica se il volo è stato passato alla classe inferiore | 
| BaggageInsurance | Stringa | assicurazione bagagli | 
| MaxAllowedBaggage | Stringa | Numero massimo di bagagli consentito | 
| BaggageQuantity | Stringa | Numero di borse | 
| BaggageFee | Stringa | Tariffa totale per il bagaglio | 
| Arrivo | Porta | Dettagli di arrivo per Segment | 
| Partenza | Porta | Dettagli di partenza per Segment | 
| Seat | Seat | Dettagli del posto | 
| Priorità | Priorità | Dettagli della priorità | 
| Doc | Doc | Informazioni sul documento di accompagnamento per il viaggio | 
| Bagagli | Elenco bagagli | Dettagli del bagaglio | 
| Animali domestici | Elenco degli animali domestici | Dettagli sugli animali domestici | 
| OtherServices | OtherService Elenco | Dettagli di altri servizi | 
| Attributes | Mappa <String, String> | Attributi aggiuntivi | 


**Campi dell’indice standard**  

| Nome dell’indice standard | Campo di registrazione delle preferenze standard | 
| --- | --- | 
| \$1airSegmentId | SegmentId | 
| \$1airBookingRef | BookingRef | 


**Tipo di dati del bagaglio**  

| Campo airSegment standard | Tipo | Description | 
| --- | --- | --- | 
| Id | Stringa | Identificativo del bagaglio | 
| TagNumber | Stringa | Numero dell’etichetta del bagaglio | 
| DepartureDate | Stringa | Data della partenza | 
| BaggageType | Stringa | Tipo di bagaglio | 
| Weight | Stringa | Peso del bagaglio | 
| Lunghezza | Stringa | Lunghezza del bagaglio | 
| Larghezza | Stringa | Larghezza del bagaglio | 
| Altezza | Stringa | Altezza del bagaglio | 
| PriorityBagDrop | Stringa | Servizio prioritario di consegna bagagli | 
| PriorityBagReturn | Stringa | Servizio prioritario di restituzione bagagli | 
| HandsFreeBaggage | Stringa | Servizio bagagli a mani libere | 
| Tariffa | Stringa | Tariffa bagaglio | 
| IsGateBag | Stringa | Indica il bagaglio da imbarcare al gate | 
| IsHeavy | Stringa | Indica un bagaglio pesante | 


**Tipo di dati del posto**  

| Campo airSegment standard | Tipo | Description | 
| --- | --- | --- | 
| SeatNumber | Stringa | Numero del posto | 
| SeatZone | Stringa | Zona del posto | 
| SeatType | Stringa | Tipo di posto | 
| Prezzo | Stringa | Prezzo del posto | 
| NeighborFree | Stringa | Indica se il posto adiacente è libero | 
| UpgradeAuction | Stringa | Indica la disponibilità degli upgrade all’asta | 
| Disponibilità | Stringa | Indica la disponibilità dei posti | 
| ExtraSeat | Stringa | Indica un posto supplementare | 
| AdditionalInformation | Stringa | Informazioni sul posto supplementare | 


**Tipo di dati della porta**  

| Campo airSegment standard | Tipo | Description | 
| --- | --- | --- | 
| Location (Ubicazione) | Stringa | Nome dell’ubicazione | 
| Codice | Stringa | Codice dell’aeroporto | 
| Terminale | Stringa | Terminal dell’aeroporto | 
| Paese | Stringa | Paese dell’aeroporto | 
| Data | Stringa | Data | 
| Orario | Stringa | Orario | 
| EstimatedTime | Stringa | Tempo stimato | 
| ScheduledTime | Stringa | Orario pianificato | 


**Tipo di dati prioritario**  

| Campo airSegment standard | Tipo | Description | 
| --- | --- | --- | 
| TransactionId | Stringa | Identificatore della transazione | 
| PriorityServiceType | Stringa | Tipo di servizio prioritario | 
| LoungeAccess | Stringa | Indica l’accesso alla lounge | 
| Prezzo | Stringa | Prezzo del servizio prioritario | 
| AdditionalInformation | Stringa | Informazioni sulla priorità supplementari | 


**Tipo di dati sugli animali domestici**  

| Campo airSegment standard | Tipo | Description | 
| --- | --- | --- | 
| Specie | Stringa | Specie di animali domestici | 
| Razza | Stringa | Razza da compagnia | 
| Weight | Stringa | Peso dell’animale domestico | 
| WeightUnit | Stringa | Unità di misura del peso | 
| TransportType | Stringa | Tipo di trasporto per animali domestici | 


**OtherService tipo di dati**  

| Campo airSegment standard | Tipo | Description | 
| --- | --- | --- | 
| ServiceType | Stringa | Tipo di servizio | 
| Description | Stringa | Descrizione del servizio | 
| Prezzo | Stringa | Prezzi del servizio | 


**Tipo di dati del documento**  

| Campo airSegment standard | Tipo | Description | 
| --- | --- | --- | 
| DocType | Stringa | Tipo di documento  | 
| DocTypeNeeded | Stringa | Indica se il documento è richiesto | 
| Nazionalità | Stringa | Nazionalità sul documento | 
| DateOfBirth | Stringa | Data di nascita | 
| AppId | Stringa | Identificatore dell'applicazione | 
| AgentId | Stringa | Identificativo dell’agente | 
| VerifiedDateTime | Stringa | Orario di verifica del documento | 

# Mappatura del tipo di oggetto per la prenotazione alberghiera standard
<a name="object-type-mapping-standard-hotel-reservation"></a>

Gli argomenti di questa sezione forniscono la definizione standard di prenotazione alberghiera.

**Topics**
+ [

# Campi oggetto prenotazione alberghiera standard di Profili dei clienti
](standard-hotel-reservation-object-fields.md)

# Campi oggetto prenotazione alberghiera standard di Profili dei clienti
<a name="standard-hotel-reservation-object-fields"></a>

La tabella seguente elenca tutti i campi nell’oggetto prenotazione alberghiera di Profili dei clienti.


**Prenotazione alberghiera**  

| Campo hotelReservation standard | Tipo | Description | 
| --- | --- | --- | 
| ReservationId | Stringa | Identificatore univoco della prenotazione alberghiera standard | 
| ConfirmationNumber | Stringa | Numero di conferma fornito dall’hotel o dal motore di prenotazione | 
| PreferenceRef | Stringa | L’identificativo che fa riferimento all’oggetto Preference per la prenotazione | 
| Status | Stringa | Stato attuale della prenotazione (ad esempio, confermata, annullata) | 
| TripType | Stringa | Scopo o natura del viaggio (ad esempio, tempo libero, lavoro) | 
| BrandCode | Stringa | Codice che rappresenta il marchio dell’hotel | 
| HotelCode | Stringa | Codice che identifica l’hotel specifico | 
| PhoneNumber | Stringa | Numero di telefono di contatto per la prenotazione | 
| EmailAddress | Stringa | Indirizzo e-mail di contatto per la prenotazione | 
| GroupId | Stringa | ID che collega la prenotazione a una prenotazione di gruppo | 
| ContextId | Stringa | Identificatore specifico del contesto per tracciare l’origine della prenotazione | 
| ProcessedDate | Stringa | Timestamp in cui è stata elaborata la prenotazione | 
| CreatedDate | Stringa | Il timestamp di quando è stata creata la prenotazione | 
| CreatedBy | Stringa | Identificatore di chi user/system ha creato la prenotazione | 
| UpdatedDate | Stringa | Data e ora dell’ultimo aggiornamento della prenotazione | 
| UpdatedBy | Stringa | Identificatore di chi ha aggiornato user/system la prenotazione | 
| AgentId | Stringa | ID dell’agente che gestisce la prenotazione | 
| Chi effettua la prenotazione | Stringa | Indica se il profilo è di chi effettua la prenotazione | 
| SameDayRate | Stringa | Indica se la prenotazione è stata effettuata per lo stesso giorno | 
| Rimborsabile | Stringa | Indica se la prenotazione è rimborsabile | 
| CancellationCharge | Stringa | Costo di cancellazione, se applicabile. 0 significa nessun addebito | 
| TransactionId | Stringa | Identificatore univoco della transazione | 
| AmountPerNight | Stringa | Importo addebitato per notte per camera | 
| AdditionalNote | Stringa | Note o istruzioni speciali | 
| NumberOfNights | Stringa | Numero di notti in prenotazione | 
| NumberOfGuests | Stringa | Numero totale di ospiti in prenotazione | 
| TotalAmountBeforeTax | Stringa | Costo totale al lordo delle imposte | 
| TotalAmountAfterTax | Stringa | Costo totale al netto delle imposte | 
| Check-out | CheckOut | Dettagli del check-out | 
| Fidelizzazione | Fidelizzazione | Dettagli della fidelizzazione | 
| Stanza | Stanza | Dettagli della camera | 
| CheckIn | CheckIn | Dettagli del check-in | 
| Pagamento | Pagamento | Dettagli del pagamento | 
| Valuta | Valuta | Dettagli sulla valuta | 
| Annullamento | Annullamento | Dettagli dell’annullamento | 
| Canale | Canale | Dettagli del canale | 
| RatePlan | RatePlan | Dettagli del piano tariffario | 
| Ospiti | Ospiti | Dettagli dell’ospite | 
| Servizi | Elenco servizi | Elenco dei servizi | 
| Attributes | Mappa <String, String> | Attributi aggiuntivi | 


**Campi dell’indice standard**  

| Nome dell’indice standard | Campo di registrazione delle preferenze standard | 
| --- | --- | 
| \$1hotelReservationId | ReservationId | 
| \$1hotelPreferenceRef | preferenceRef | 


**Tipo di dati del check-out**  

| Campo hotelReservation standard | Tipo | Description | 
| --- | --- | --- | 
| Anticipato | Stringa | Il check-out anticipato è programmato o richiesto | 
| Posticipato | Stringa | Il check-out posticipato è programmato o richiesto | 
| Personale | Stringa | Il check-out automatico è programmato o richiesto | 
| Data | Stringa | Data di check-out della prenotazione | 


**Tipo di dati della fidelizzazione**  

| Campo hotelReservation standard | Tipo | Description | 
| --- | --- | --- | 
| ProgramName | Stringa | Nome del programma di fidelizzazione | 
| MembershipId | Stringa | ID del socio nel programma di fidelizzazione | 
| Livello | Stringa | Livello o livello di fidelizzazione | 


**Tipo di dati della camera**  

| Campo hotelReservation standard | Tipo | Description | 
| --- | --- | --- | 
| TypeCode | Stringa | Codice per tipo/categoria di camera | 
| TypeName | Stringa | Nome del tipo di camera | 
| TypeDesc | Stringa | Descrizione del tipo di camera | 
| Numero | Stringa | Numero di camera assegnato | 
| Capacity | Stringa | Capacità massima della camera | 
| AccessibilityType | Stringa | Funzionalità di accessibilità | 
| SmokingAllowed | Stringa | Indica se è consentito fumare in camera | 


**CheckIn tipo di dati**  

| Campo hotelReservation standard | Tipo | Description | 
| --- | --- | --- | 
| Data | Stringa | Data di check-in della prenotazione | 
| DigitalKey | Stringa | Indica se è stata consegnata una chiave digitale della stanza | 
| Anticipato | Stringa | Indica se è stato richiesto il check-in anticipato | 
| Posticipato | Stringa | Indica se è stato richiesto il check-in posticipato | 
| RoomKeys | Stringa | Numero di chiavi della camera consegnate | 
| UserSelectedRoom | Stringa | True se l’ospite ha selezionato la propria stanza | 


**Tipo di dati del pagamento**  

| Campo hotelReservation standard | Tipo | Description | 
| --- | --- | --- | 
| Tipo | Stringa | Tipo di metodo di pagamento (ad es. credito, debito, voucher) | 
| CreditCardToken | Stringa | Numero di carta di credito tokenizzato | 
| CreditCardType | Stringa | Tipo di carta di credito (ad es. Visa, Amex) | 
| CreditCardExpiration | Stringa | Data di scadenza della carta di credito | 
| Cvv | Stringa | Valore verifica della carta | 
| NameOnCreditCard | Stringa | Nome stampato sulla carta di credito | 
| RoutingNumber | Stringa | Numero di routing bancario | 
| AccountNumber | Stringa | Numero del conto bancario | 
| VoucherId | Stringa | Identificatore del voucher, se utilizzato | 
| DiscountCode | Stringa | Codice sconto applicato | 
| DiscountPercent | Stringa | Percentuale di sconto applicata | 


**Tipo di dati della valuta**  

| Campo hotelReservation standard | Tipo | Description | 
| --- | --- | --- | 
| Codice | Stringa | Codice ISO per la valuta (ad esempio, USD) | 
| Name | Stringa | Nome completo della valuta (ad esempio, dollaro statunitense) | 
| Symbol | Stringa | Simbolo della valuta (ad esempio, \$1) | 


**Tipo di dati di cancellazione**  

| Campo hotelReservation standard | Tipo | Description | 
| --- | --- | --- | 
| Motivo | Stringa | Motivo dell’annullamento | 
| Comment | Stringa | Note di annullamento aggiuntive | 


**Tipo di dati del canale**  

| Campo hotelReservation standard | Tipo | Description | 
| --- | --- | --- | 
| CreationChannelId | Stringa | ID del canale attraverso il quale è stata effettuata la prenotazione | 
| LastUpdatedChannelId | Stringa | ID del canale che ha aggiornato l’ultima volta la prenotazione | 
| Metodo | Stringa | Metodo utilizzato per la prenotazione (ad es. web, app per dispositivi mobili) | 


**RatePlan tipo di dati**  

| Campo hotelReservation standard | Tipo | Description | 
| --- | --- | --- | 
| Codice | Stringa | Codice identificativo del piano tariffario prenotato | 
| Name | Stringa | Nome del piano tariffario prenotato | 
| Description | Stringa | Descrizione del piano tariffario | 


**Tipo di dati del servizio**  

| Campo hotelReservation standard | Tipo | Description | 
| --- | --- | --- | 
| ServiceType | Stringa | Tipo di servizio (ad es. spa, colazione) | 
| Description | Stringa | Descrizione del servizio | 
| Costo | Stringa | Costo del servizio | 


**Tipo di dati dell’ospite**  

| Campo hotelReservation standard | Tipo | Description | 
| --- | --- | --- | 
| Adulti | Stringa | Numero di ospiti adulti | 
| Bambini | Stringa | Numero di ospiti bambini | 

# Mappatura del tipo di oggetto per la fidelizzazione standard
<a name="object-type-mapping-standard-loyalty"></a>

Gli argomenti contenuti in questa sezione forniscono la definizione standard di fidelizzazione.

**Topics**
+ [

# Campi dell’oggetto fidelizzazione standard di Profili dei clienti
](standard-loyalty-object-fields.md)

# Campi dell’oggetto fidelizzazione standard di Profili dei clienti
<a name="standard-loyalty-object-fields"></a>

La tabella seguente elenca tutti i campi nell’oggetto fidelizzazione standard di Profili dei clienti.


**Fidelizzazione**  

| Campo fidelizzazione standard | Tipo | Description | 
| --- | --- | --- | 
| LoyaltyId | Stringa | Identificatore univoco della fidelizzazione standard | 
| ProgramId | Stringa | Identificatore del programma di fidelizzazione | 
| MembershipId | Stringa | Identificativo alternativo all’interno del programma | 
| ProgramName | Stringa | Nome del programma di fidelizzazione | 
| Gruppo | Stringa | Gruppo o categoria del programma di fidelizzazione | 
| Canale | Stringa | Canale attraverso il quale si accede al programma di fidelizzazione | 
| CreatedDate | Stringa | Data di creazione dell’account di fidelizzazione | 
| EnrollmentDate | Stringa | Data di iscrizione del cliente al programma | 
| CreatedBy | Stringa | Utente o sistema che ha creato l’account di fidelizzazione | 
| UpdatedDate | Stringa | Data dell’ultimo aggiornamento dell’account di fidelizzazione | 
| LastUpdatedBy | Stringa | Utente o sistema che ha aggiornato l’ultimo account di fidelizzazione | 
| UpgradeDate | Stringa | Data dell’ultimo upgrade del livello | 
| RenewalDate | Stringa | Data di rinnovo dell’iscrizione al programma di fidelizzazione | 
| AdditionalInformation | Stringa | Qualsiasi informazione aggiuntiva | 
| EmailAddress | Stringa | L’indirizzo e-mail del cliente | 
| EmailAddressVerified | Stringa | Contrassegno che indica se l’e-mail è verificata | 
| PhoneNumber | Stringa | Il numero di telefono del cliente. | 
| PhoneNumberVerified | Stringa | Contrassegno che indica se il numero di telefono è verificato | 
| Status | Stringa | Stato attuale del conto di fidelizzazione | 
| Livello | Livello | Dettagli del livello | 
| Punti | Punti | Dettagli dei punti | 
| PointExpirations | PointExpiration elenco | Dettagli della scadenza dei punti | 
| Pagamento | Pagamento | Dettagli del pagamento | 
| PaymentInformation | PaymentInformation | Dettagli delle informazioni di pagamento | 
| BillingAddress | Indirizzo della fidelizzazione | Dettagli dell’indirizzo | 
| Attributes | Mappa <String, String> | Attributi aggiuntivi altrimenti non considerati | 


**Campi dell’indice standard**  

| Nome dell’indice standard | Campo di registrazione delle preferenze standard | 
| --- | --- | 
| \$1loyaltyId | LoyaltyId | 
| \$1loyaltyMembershipId | membershipId | 


**Tipo di dati dell’indirizzo di fidelizzazione**  

| Campo airPreference standard | Tipo di dati | Description | 
| --- | --- | --- | 
| Address1 | Stringa | La prima riga dell'indirizzo di un cliente. | 
| Address2 | Stringa | La seconda riga dell'indirizzo di un cliente. | 
| Address3 | Stringa | La terza riga dell'indirizzo di un cliente. | 
| Address4 | Stringa | La quarta riga dell'indirizzo di un cliente. | 
| City | Stringa | La città in cui vive il cliente. | 
| Paese | Stringa | Il paese in cui vive il cliente. | 
| County | Stringa | La contea in cui vive il cliente. | 
| PostalCode | Stringa | Il codice postale dell'indirizzo del cliente. | 
| Province | Stringa | La provincia in cui vive il cliente. | 
| Stato | Stringa | Lo stato in cui vive il cliente. | 


**Tipo di dati del livello**  

| Campo fidelizzazione standard | Tipo | Description | 
| --- | --- | --- | 
| CurrentTier | Stringa | L’attuale livello di fidelizzazione del cliente | 
| NextTier | Stringa | Il possibile livello successivo per il cliente | 
| PointsToNextTier | Stringa | Punti necessari per raggiungere il livello successivo | 


**Tipo di dati relativi ai punti**  

| Campo fidelizzazione standard | Tipo | Description | 
| --- | --- | --- | 
| Points.Unit | Stringa | Unità di misura per i punti | 
| Points.Lifetime | Stringa | Punti totali guadagnati a vita | 
| Points.Balance | Stringa | Saldo punti attuale | 
| Points.Redeemed | Stringa | Totale punti riscattati | 


**PointExpiration tipo di dati**  

| Campo fidelizzazione standard | Tipo | Description | 
| --- | --- | --- | 
| Punti | Stringa | Punti in scadenza | 
| Data | Stringa | Data di scadenza dei punti | 


**Tipo di dati del pagamento**  

| Campo fidelizzazione standard | Tipo | Description | 
| --- | --- | --- | 
| Tipo | Stringa | Tipo di pagamento | 
| CreditCardToken | Stringa | Riferimento di carte di credito tokenizzate | 
| CreditCardType | Stringa | Tipo di carta di credito (ad es. Visa, Amex) | 
| CreditCardExpiration | Stringa | Data di scadenza della carta di credito | 
| Cvv | Stringa | Valore verifica della carta | 
| NameOnCreditCard | Stringa | Nome sulla carta | 
| RoutingNumber | Stringa | Numero di routing bancario | 
| AccountNumber | Stringa | Numero del conto bancario | 
| VoucherId | Stringa | Identificatore del voucher | 


**PaymentInformation tipo di dati**  

| Campo fidelizzazione standard | Tipo | Description | 
| --- | --- | --- | 
| Schedule | Stringa | Scadenzario dei pagamenti | 
| LastPaymentDate | Stringa | Data dell’ultimo pagamento | 
| NextPaymentDate | Stringa | Data del pagamento successivo | 
| NextBillAmount | Stringa | Importo della fattura successiva | 
| CurrencyCode | Stringa | Codice valuta (ad esempio, USD) | 
| CurrencyName | Stringa | Nome completo della valuta | 
| CurrencySymbol | Stringa | Simbolo della valuta (ad es. \$1) | 

# Mappatura del tipo di oggetto per la transazione di fidelizzazione standard
<a name="object-type-mapping-standard-loyalty-transaction"></a>

Gli argomenti di questa sezione forniscono la definizione standard della transazione di fidelizzazione.

**Topics**
+ [

# Campi oggetto della transazione di fidelizzazione standard di Profili dei clienti
](standard-loyalty-transaction-object-fields.md)

# Campi oggetto della transazione di fidelizzazione standard di Profili dei clienti
<a name="standard-loyalty-transaction-object-fields"></a>

La tabella seguente elenca tutti i campi nell’oggetto transazione di fidelizzazione di Profili dei clienti.


**Transazione di fidelizzazione**  

| Campo loyaltyTransaction standard | Tipo | Description | 
| --- | --- | --- | 
| TransactionId | Stringa | Identificativo univoco della transazione di fidelizzazione standard. | 
| TransactionName | Stringa | Nome o etichetta della transazione. | 
| TransactionType | Stringa | Tipo di transazione (ad esempio, guadagna, riscatta, adegua). | 
| ProgramRef | Stringa | Riferimento al programma di fidelizzazione associato. | 
| MembershipRef | Stringa | Riferimento all’iscrizione della fidelizzazione utilizzata nella transazione. | 
| PromotionRef | Stringa | Riferimento a una promozione che ha influenzato questa transazione. | 
| CreatedDate | Stringa | Data di creazione della transazione. | 
| TransactionDate | Stringa | Data in cui è avvenuta la transazione. | 
| Industry | Stringa | Settore associato alla transazione (ad es. compagnia aerea, hotel). | 
| Location (Ubicazione) | Stringa | Luogo in cui è avvenuta la transazione. | 
| CreatedBy | Stringa | Identificativo di chi ha creato la transazione. | 
| UpdatedDate | Stringa | La data dell’ultimo aggiornamento della trasformazione. | 
| UpdatedBy | Stringa | Identificativo dell’ultimo aggiornamento della transazione. | 
| Status | Stringa | L’attuale stato della transazione. | 
| AccrualType | Stringa | Metodo di accumulo (manuale, automatizzato, ecc.). | 
| Categoria | Stringa | Categoria della transazione (ad es. volo, soggiorno in hotel). | 
| Canale | Stringa | Canale in cui è stata avviata la transazione (ad esempio, online, in negozio). | 
| ProductId | Stringa | Identificativo del prodotto o servizio collegato alla transazione. | 
| Amount (Quantità) | Stringa | Importo speso o negoziato nella transazione. | 
| OriginValue | Stringa | Valore originale prima di qualsiasi conversione o offset. | 
| OriginValueCurrency | Stringa | Valuta del valore della transazione originale. | 
| OriginValueOffset | Stringa | Adeguamento al valore originale per promozioni, rimborsi, ecc. | 
| PointsEarned | Stringa | Punti totali guadagnati in seguito a questa transazione. | 
| PointOffset | Stringa | Punti adeguati (ad es. bonus, penalità). | 
| QualifyingPointsEarned | Stringa | Punti che contano ai fini della qualificazione di livello. | 
| TierBefore | Stringa | Livello cliente prima della transazione. | 
| TierAfter | Stringa | Livello cliente dopo la transazione. | 
| Marchio | Stringa | Marchio associato alla transazione. | 
| Description | Stringa | Descrizione narrativa della transazione. | 
| AdditionalInformation | Stringa | Informazioni aggiuntive in formato libero relative alla transazione. | 
| PaymentMethod | Stringa | Tipo di metodo di pagamento (ad es. carta, voucher). | 
| PointTransfer | PointTransfer | Dettagli del trasferimento dei punti | 
| Attributes | Mappa <String, String> | Attributi aggiuntivi. | 


**Campi dell’indice standard**  

| Nome dell’indice standard | Campo di registrazione delle preferenze standard | 
| --- | --- | 
| \$1loyaltyTransactionId | TransactionId | 


**PointTransfer tipo di dati**  

| Campo loyaltyTransaction standard | Tipo | Description | 
| --- | --- | --- | 
| TransferId | Stringa | Identificativo della transazione di trasferimento. | 
| SourceProgramId | Stringa | ID del programma di fidelizzazione di origine. | 
| DestinationProgrmId | Stringa | ID del programma di fidelizzazione di destinazione. | 
| SourceMembershipId | Stringa | ID di iscrizione al programma di origine. | 
| DestinationMembershipId | Stringa | ID di iscrizione al programma di destinazione. | 
| PointsTransferred | Stringa | Punti detratti dal programma di origine. | 
| PointsReceived | Stringa | Punti accreditati nel programma di destinazione. | 

# Mappatura del tipo di oggetto per la promozione della fidelizzazione standard
<a name="object-type-mapping-standard-loyalty-promotion"></a>

Gli argomenti di questa sezione forniscono la definizione standard di promozione della fidelizzazione.

 utilizzo di 

**Topics**
+ [

# Campi dell’oggetto promozione della fidelizzazione standard di Profili dei clienti
](standard-loyalty-promotion-object-fields.md)

# Campi dell’oggetto promozione della fidelizzazione standard di Profili dei clienti
<a name="standard-loyalty-promotion-object-fields"></a>

La tabella seguente elenca tutti i campi nell’oggetto della promozione della fidelizzazione standard di Profili dei clienti.


**Promozione della fidelizzazione**  

| Campo loyaltyPromotion standard | Tipo | Description | 
| --- | --- | --- | 
| PromotionId | Stringa | Identificativo univoco della promozione di fidelizzazione standard. | 
| PromotionName | Stringa | Visualizza il nome della promozione. | 
| PromotionType | Stringa | Il tipo o la categoria della promozione (ad esempio, bonus, passaggio di livello, voucher). | 
| ProgramType | Stringa | Indica il tipo di programma di fidelizzazione a cui è legata la promozione. | 
| ProgramRef | Stringa | ID di riferimento al relativo programma di fidelizzazione. | 
| PartnerId | Stringa | ID di riferimento di un’organizzazione partner coinvolta nella promozione. | 
| PartnerNumber | Stringa | Un identificativo o un numero relativo al partner. | 
| Livello | Stringa | Livello mirato o influenzato dalla promozione. | 
| StartDate | Stringa | Quando la promozione diventa attiva. | 
| EnrolledDate | Stringa | Data in cui l’utente si è iscritto alla promozione. | 
| EndDate | Stringa | Quando termina la promozione. | 
| Amount (Quantità) | Stringa | Valore monetario o in punti associato alla promozione. | 
| Periodo | Stringa | Periodo di validità della promozione (ad esempio settimanale, mensile, basato sulla campagna). | 
| Status | Stringa | Stato attuale della promozione (ad esempio, attiva, scaduta, completata). | 
| CreatedDate | Stringa | Data di creazione del record della promozione. | 
| CreatedBy | Stringa | Utente o sistema che ha creato il record della promozione. | 
| UpdatedDate | Stringa | Data più recente in cui il record della promozione è stato aggiornato. | 
| UpdatedBy | Stringa | Utente o sistema che ha aggiornato per ultimo la promozione. | 
| CampaignRef | Stringa | Riferimento esterno a una campagna più ampia a cui appartiene questa promozione. | 
| AdditionalInformation | Stringa | Note varie o testi di marketing sulla promozione. | 
| TriggerLimit | TriggerLimit | Dettagli del limite di attivazione | 
| Utilizzo | Utilizzo | Dettagli dell’utilizzo | 
| Regole | Regole | Dettagli delle regole di promozione | 
| Incentivo | Incentivo | Dettagli dell’incentivo alla promozione | 
| Attributes | Mappa <String, String> | Metadati aggiuntivi o valori specifici del programma. | 


**Campi dell’indice standard**  

| Nome dell’indice standard | Campo di registrazione delle preferenze standard | 
| --- | --- | 
| \$1loyaltyPromotionId | PromotionId | 


**Tipo di dati delle regole**  

| Campo loyaltyPromotion standard | Tipo | Description | 
| --- | --- | --- | 
| Nome | Stringa | Nome della regola all’interno delle regole di promozione. | 
| Description | Stringa | Descrizione della regola all’interno delle regole di promozione. | 


**Tipo di dati dell’incentivo**  

| Campo loyaltyPromotion standard | Tipo | Description | 
| --- | --- | --- | 
| Tipo | Stringa | Il tipo di incentivo (ad es. bonusPoints, voucher, tierUpgrade). | 
| Valore | Stringa | Valore dell’incentivo, ad esempio l’importo dei punti o il valore del voucher. | 
| Unità | Stringa | L’unità per il valore dell’incentivo (ad esempio, punti, %, USD). | 


**TriggerLimit tipo di dati**  

| Campo loyaltyPromotion standard | Tipo | Description | 
| --- | --- | --- | 
| Volte | Stringa | Numero di volte in cui è possibile attivare una promozione. | 
| Interval | Stringa | Intervallo per il limite di attivazione. | 


**Tipi di dati di utilizzo**  

| Campo loyaltyPromotion standard | Tipo | Description | 
| --- | --- | --- | 
| UsageProgressPercent | Stringa | Percentuale di avanzamento dell’utilizzo della promozione. | 
| UsageCompleted | Stringa | Numero di utilizzi completati. | 
| UsageTarget | Stringa | Numero target di utilizzi. | 

# mappatura dei tipi di oggetto per Web Analytics Object
<a name="standard-loyalty-promotion-object-mapping-web-analytics"></a>


**WebAnalytics Schema a oggetti standard**  

| Campo | Tipo | Description | 
| --- | --- | --- | 
|  Attributi di eventi  | 
|  EventId  |  Stringa  |  Identificatore univoco per un evento di analisi web.  | 
|  EventType  |  Stringa  | Tipo di evento di analisi web, ad esempio: visualizzazione della pagina, invio del modulo, clic sui pulsanti,Apri la linea principale\$1 u0000Interazione con la barra di ricerca, messaggi di errore delle app, interazioni con il carrello, acquisti, scorrimenti, ecc. | 
|  EventTimestamp  |  Numero  |  Timestamp epoch (millisecondi) dell'evento.  | 
|  EventDuration  |  Numero  |  EventDuration rappresenta la quantità di tempo che un utente trascorre durante una particolare interazione, misurata in secondi. I casi d'uso più comuni includono: tempo impiegato a visualizzare un prodotto, durata di una sessione di navigazione su una determinata pagina, tempo dedicato a una funzionalità, ecc.  | 
|  EventValue  |  Numero  |  EventValue è un attributo numerico che rappresenta il valore o l'importanza di un evento di interazione. I casi d'uso più comuni includono: importo dell'acquisto per gli eventi di transazione, valori di valutazione per le valutazioni dei prodotti, percentuale di completamento per le visualizzazioni dei video, ecc.  | 
|  Attributi di sessione  | 
|  ID sessione  |  Stringa  |  Identificatore univoco per la sessione.  | 
|  Sessione. StartTimestamp  |  Numero  |  Epoca in millisecondi che indica il timestamp di inizio della sessione.  | 
|  Attributi pagina/schermo  | 
|  Pagina.Title  |  Stringa  |  Titolo di un App/Screen nome Web per un'app mobile.  | 
|  Pagina. Posizione  |  Stringa  |  URL di una pagina Web. Per dispositivi mobili, potrebbe trattarsi di un collegamento diretto o di un percorso verso lo schermo.  | 
|  Pagina.Referrer  |  Stringa  |  Schermata/pagina precedente.  | 
|  Pagina.Categoria  |  Stringa  |  Raggruppamento logico di una posizione. screen/page. Might be useful to group nested URLs/app  | 
|  Elementi HTML/DOM  | 
|  Element.Id  |  Stringa  |  ID elemento HTML  | 
|  Element.Type  |  Stringa  |  Tipo di elemento: pulsante, collegamenti di ancoraggio, ecc.  | 
|  Element.Classes  |  Stringa  |  Classi di stile CSS dell'elemento  | 
|  Element.Text  |  Stringa  |  Elemento di testo (utile per pulsanti, campi di input, segnaposto, ecc.).  | 
|  Elemento. AltText  |  Stringa  |  AltText di un elemento HTML (generalmente utilizzato per le immagini).  | 
|  Elemento.Source  |  Stringa  |  Fonte di un video, di un'immagine, ecc.  | 
|  Modulo  | 
|  Form.Id  |  Stringa  |  Identificatore univoco per un modulo di input  | 
|  Nome del modulo  |  Stringa  |  Nome del modulo  | 
|  Form.Length  |  Stringa  |  Numero di campi di input in un modulo.  | 
|  Modulo. ValidationErrors  |  Numero  |  Numero di errori di convalida nel modulo.  | 
|  Modulo. FieldsCompleted  |  Numero  |  Numero di campi completati.  | 
|  Modulo. FieldsRequired  |  Numero  |  Numero di campi obbligatori.  | 
|  Cerca  | 
|  Search.Query  |  Stringa  |  Stringa di query utilizzata nell'input  | 
|  Ricerca. TotalMatchingResults  |  Numero  |  Numero totale di risultati di ricerca.  | 
|  Ricerca. ResultsPerPage  |  Numero  |  Numero di risultati visualizzati per pagina.  | 
|  Ricerca. CurrentResultsPage  |  Numero  |  Pagina dei risultati correnti che l'utente sta visualizzando.  | 
|  Ricerca. FilterExpression  |  Stringa  |  Eventuali espressioni di filtro aggiuntive utilizzate.  | 
|  Ricerca. SortCriteria  |  Stringa  |  Criteri per l'ordinamento dei risultati della ricerca. Ad esempio: rilevanza, prezzo, ecc.  | 
|  Ricerca. SortOrder  |  Stringa  |  Ordinamento per i risultati della ricerca: crescente/decrescente.  | 
|  Articolo/Elenco articoli  | 
|  Elemento  |  Elemento  |  Elemento focalizzato in un evento, che indica l'articolo aggiunto al carrello, l'articolo visualizzato, ecc.  | 
|  ItemsList  |  Elenco <Item>  |  Elenco mirato degli articoli di un evento, con indicazione degli articoli acquistati, degli articoli nel carrello, dei risultati della ricerca degli articoli, ecc.  | 
|  Impressioni sugli articoli  | 
|  AdditionalItemImpressions  |  Elenco <Item>  |  Elenco di impressioni aggiuntive sugli articoli  | 
|  Carrello  | 
|  ID del carrello  |  Stringa  |  Identificatore univoco per un carrello.  | 
|  Carrello. ItemsCount  |  Numero  |  Numero di articoli nel carrello.  | 
|  Carrello. Valuta  |  Stringa  |  Valuta del valore del carrello.  | 
|  Cart.Value  |  Numero  |  Valore monetario degli articoli nel carrello.  | 
|  Informazioni sull'ordine  | 
|  OrderId  |  Stringa  |  Identificatore univoco per un ordine. Qui memorizzeremo solo l'identificativo dell'ordine, altre informazioni relative all'ordine verranno memorizzate nell'oggetto dell'ordine standard.  | 
|  Dispositivo  | 
|  DeviceId  |  Stringa  |  Identificatore univoco del dispositivo dell'utente.  | 
|  Attributi di scor  | 
|  Scorri. DepthPercentage  |  Stringa  |  Percentuale di profondità di scorrimento verticale. Questo aiuta a capire fino a che punto un utente scorre all'interno di una pagina web.  | 
|  scroll.positionX  |  Numero  |  Posizione di scorrimento orizzontale in pixel da sinistra.  | 
|  Scroll.positionY  |  Numero  |  Posizione di scorrimento verticale in pixel dall'alto.  | 
|  Errore  | 
|  Errore. Descrizione  |  Stringa  |  Breve descrizione dell'errore.  | 
|  Error.Type  |  Stringa  |  Errore di input dell'utente. Error/Server   | 
|  Utente  | 
|  User.Id  |  Stringa  |  Identificatore univoco dell'utente  | 
|  Utente. AnonymousId  |  Stringa  |  Anonimo UserId. Si tratterebbe di un ID univoco assegnato a un utente quando non ha effettuato l'accesso.  | 
|  Utente. IsReturning  |  Stringa  |  Un valore booleano che indica se un utente sta rivisitando.  | 
|  Utente. IsLoggedIn  |  Stringa  |  Un valore booleano che indica se un utente ha effettuato l'accesso.  | 
|  Activity location (Posizione attività)  | 
|  Location.Country  |  Stringa  |  Paese di attività dell'utente.  | 
|  Ubicazione. Stato  |  Stringa  |  Stato dell'attività dell'utente.  | 
|  Ubicazione. Provincia  |  Stringa  |  Provincia di attività dell'utente.  | 
|  Ubicazione. Provincia  |  Stringa  |  Contea delle attività degli utenti.  | 
|  Ubicazione. Città  |  Stringa  |  Città delle attività degli utenti.  | 
|  Ubicazione. Latitudine  |  Stringa  |  Coordinate della posizione dell'attività dell'utente  | 
|  Ubicazione. Longitudine  |  Stringa  |  Coordinate della posizione dell'attività dell'utente  | 
|  Attributi dell'applicazione  | 
|  Nome dell'applicazione  |  Stringa  |  Il nome dell'applicazione.  | 
|  Versione dell'applicazione  |  Stringa  |  Se il dispositivo è mobile, possiamo acquisire la versione dell'applicazione qui. L'utente potrebbe anche prendere in considerazione l'idea di utilizzarlo per i A/B test sulla popolazione o gli attributi di sperimentazione.  | 
|  Ambiente di applicazione  |  Stringa  |  Ambienti applicativi, come Beta, Gamma, Prod.  | 
|  Attributi personalizzati  | 
|  Attributes  |  Mappa <String, String>  |  Eventuali attributi o metadati personalizzati da aggiungere all'evento.  | 


**WebAnalytics Schema dell'oggetto dell'oggetto**  

| Campo | Tipo | Description | 
| --- | --- | --- | 
|  Id  |  Stringa  |  Identificatore univoco dell'articolo.  | 
|  Titolo  |  Stringa  |  Titolo dell'articolo.  | 
|  Categoria  |  Stringa  |  Categoria dell'articolo.  | 
|  Valore  |  Stringa  |  Valore monetario dell'articolo.  | 
|  Valuta  |  Stringa  |  Valuta dell'articolo  | 
|  Quantità  |  Numero  |  Quantità dell'articolo.  | 
|  ImpressionType  |  Stringa  |  Stringa che identifica il tipo di impressione per un evento. Ad esempio: Featured, Sponsored, Top picks, ecc.  | 
|  ImpressionId  |  Stringa  |  Un identificatore di stringa per identificare in modo univoco un'impressione.  | 


**Schema a oggetti standard del dispositivo**  

| Campo | Tipo | Description | 
| --- | --- | --- | 
|  DeviceId  |  Stringa  |  Un identificatore univoco per il dispositivo.  | 
|  Tipo  |  Stringa  |  Tipo di dispositivo (ad es. desktop, dispositivo mobile)  | 
|  Modello  |  Stringa  |  Modello di dispositivo, ad esempio Macbook Pro/Air, IPhone 16, ecc.  | 
|  Produttore  |  Stringa  |  Produttore del dispositivo.  | 
|  OperatingSystem  |  Stringa  |  Indica Windows MacOs, IOS, Android.  | 
|  OperatingSystemVersion  |  Stringa  |  Versione del sistema operativo  | 
|  ScreenWidth  |  Numero  |  Larghezza dello schermo ViewPort  | 
|  ScreenHeight  |  Numero  |  Altezza dello schermo ViewPort  | 
|  Browser  |  Stringa  |  Nome del browser con cui l'utente interagisce.  | 
|  BrowserVersion  |  Stringa  |  Versione del browser  | 
|  Locale  |  Stringa  |  Impostazioni locali del dispositivo o dell'app.  | 
|  Attributes  |  Mappa <String, String>  |  Qualsiasi attributo personalizzato per un dispositivo.  | 

# Mappatura dei tipi di oggetto per Item Catalog
<a name="standard-loyalty-promotion-object-mapping-item-catalog"></a>


| Campo | Tipo | Description | 
| --- | --- | --- | 
|  Id  | Stringa | Identificatore univoco per l'articolo nel catalogo. | 
|  Name  | Stringa | Nome dell'articolo | 
|  Codice  | Stringa | Codice dell'articolo del catalogo | 
|  Tipo  | Stringa | Tipo di articolo del catalogo | 
|  Categoria  | Stringa | Categoria dell'articolo nel catalogo | 
|  Description  | Stringa | Descrizione dell'articolo | 
|  AdditionalInformation  | Stringa | Qualsiasi informazione aggiuntiva pertinente all'articolo. | 
|  ImageLink  | Stringa | Link all'immagine dell'articolo | 
|  Link  | Stringa | URL dell'articolo | 
|  Prezzo  | Stringa | Prezzo dell'articolo | 
|  CreatedAt  | Long | Data e ora per cui l'articolo è stato creato | 
|  UpdatedAt  | Long | Timestamp dell'epoca per cui l'articolo è stato aggiornato | 
| Attributes | Mappa <String, String> | Attributi aggiuntivi dell'articolo | 

**Nota**  
È possibile eliminare il tipo di oggetto di dominio solo tramite APIs. È possibile eliminare l'integrazione del catalogo degli articoli dopo che tutti i consigliatori sono stati eliminati per primi. In questo modo si evitano problemi di dipendenza dai dati.  
**Passaggi per l'eliminazione:**  
1. Elimina tutti i consiglieri esistenti nel tuo dominio  
2. Passa all'integrazione del catalogo degli articoli.  
3. Seleziona l'opzione di eliminazione.

# Mappatura del tipo di oggetto ricavi derivanti dai soggiorni in hotel standard
<a name="object-type-mapping-standard-hotel-stay-revenue"></a>

Gli argomenti di questa sezione forniscono la definizione standard dei ricavi derivanti dai soggiorni in hotel.

**Topics**
+ [

# Campi dell’oggetto ricavi derivanti dai soggiorni in hotel standard di Profili dei clienti.
](standard-hotel-stay-revenue-object-fields.md)

# Campi dell’oggetto ricavi derivanti dai soggiorni in hotel standard di Profili dei clienti.
<a name="standard-hotel-stay-revenue-object-fields"></a>

La tabella seguente elenca tutti i campi nell’oggetto ricavi derivanti dai soggiorni in hotel standard di Profili dei clienti.


**Ricavi derivanti dai soggiorni in hotel**  

|  hotelStayRevenue Campo standard | Tipo | Description | 
| --- | --- | --- | 
| StayRevenueId | Stringa | L’identificativo univoco dei ricavi derivanti dai soggiorni in hotel standard. | 
| CurrencyCode | Stringa | Codice ISO per la valuta (ad esempio, USD) | 
| CurrencyName | Stringa | Nome completo della valuta (ad esempio, dollaro statunitense) | 
| CurrencySymbol | Stringa | Simbolo della valuta (ad esempio, \$1) | 
| ReservationId | Stringa | Identificativo univoco della prenotazione alberghiera | 
| GuestId | Stringa | Identificativo univoco dell’ospite | 
| LastUpdatedOn | Stringa | Timestamp dell’ultimo aggiornamento del record di soggiorno | 
| CreatedOn | Stringa | Il timestamp di quando è stato creato il record del soggiorno | 
| LastUpdatedBy | Stringa | Identificatore dell'ultimo user/system aggiornamento del record di soggiorno | 
| CreatedBy | Stringa | Identificatore di chi ha creato user/system il record del soggiorno | 
| StartDate | Stringa | Data di inizio del soggiorno in hotel | 
| HotelCode | Stringa | Codice che identifica l’hotel specifico | 
| Tipo | Stringa | Tipo di ricavo (ad esempio, tariffa della camera, spese accessorie, tasse) | 
| Description | Stringa | Descrizione della voce di ricavo | 
| Amount (Quantità) | Stringa | Importo dell’elemento ricavo | 
| ProcessedDate | Stringa | Data di elaborazione del ricavo | 
| Status | Stringa | Stato dell’elemento ricavo | 
| Attributes | Mappa <String, String> | Metadati aggiuntivi o valori specifici del programma. | 


**Campi dell’indice standard**  

| Nome dell’indice standard | Campo di registrazione delle preferenze standard | 
| --- | --- | 
| \$1 hotelStayRevenue Id | StayRevenueId | 

# Proprietà aggiuntive dei tipi di oggetti in Profili dei clienti
<a name="additional-properties-object-types"></a>

Un tipo di proprietà definisce quale chiave deve essere utilizzata per crittografare tutti i dati del tipo di oggetto.

Esiste un'opzione che definisce se è possibile creare nuovi profili mediante l'importazione di questo oggetto. Normalmente, quando viene importato un oggetto che non può essere abbinato a un profilo esistente, viene creato un nuovo profilo purché questa opzione sia vera. Se non è vero, l'oggetto importato viene creato e scritto nella coda DLQ del dominio.

Contiene inoltre per quanto tempo i dati di questo tipo di oggetto devono essere conservati in Profili cliente. 

**Nota**  
La conservazione dei singoli oggetti viene impostata al momento dell'importazione dei dati. La modifica della conservazione per un tipo di oggetto specifico si applica solo ai nuovi dati che vengono importati. Non si applica ai dati esistenti già importati.

**Nota**  
Se questo oggetto corrisponde a un profilo esistente, non sovrascriverà i campi compilati manualmente tramite una chiamata API o lo spazio di lavoro dell’agente, per evitare che le acquisizioni automatiche sovrascrivano quelle manuali.  
Ad esempio, supponiamo che un profilo venga creato manualmente con FirstName «John» da un agente nell'Agent Workspace. Viene importato un oggetto che mappa i dati al FirstName campo del profilo standard. Se questo oggetto si associa al profilo, non sovrascriverà «John». FirstName 

# Profili dedotti
<a name="inferred-profiles"></a>

Quando un profilo viene creato mediante l'importazione di un oggetto che non ha campi, l'oggetto del profilo standard di questo nuovo profilo è vuoto. Questo oggetto del profilo standard vuoto è un **profilo dedotto**. 

Quando si crea un profilo dedotto, i due campi seguenti vengono compilati nell'oggetto standard dall'oggetto del profilo, se disponibili.
+ Se è presente un campo definito con il tipo di contenuto di `EMAIL_ADDRESS` nell'oggetto importato, questo valore verrà compilato nel campo `EmailAddress` del profilo standard.
+ Se nell'oggetto ingerito è presente un campo con il tipo di contenuto di `PHONE_NUMBER`, questo valore verrà inserito nel campo `PhoneNumber` del profilo standard.

I valori di questi campi vengono popolati nel profilo standard anche se i campi non hanno un target definito nella definizione del campo.

Per saperne di più sui tipi di modello dei Record di contatto e su come modificare il modello utilizzato nel tuo dominio, consulta [Esempi di utilizzo del modello di record di contatto](ctr-contact-record-template.md#ctr-contact-record-template-usage-examples).

# Modelli di record di contatto in Amazon Connect Customer Profiles
<a name="ctr-contact-record-template"></a>

Un record di contatto funge da oggetto di profilo che acquisisce metadati essenziali da vari eventi di contatto, come telefonate o chat. Svolge un ruolo fondamentale nella documentazione e nell'analisi delle interazioni con i clienti. 

Quando si verifica un evento di contatto, sono disponibili tre modelli predefiniti distinti applicabili al dominio. Questi modelli fungono da opzioni di configurazione e regolano il modo in cui l'evento di contatto viene gestito all'interno del sistema. Ogni modello definisce regole e azioni specifiche, che consentono di personalizzare l'elaborazione degli eventi di contatto in base alle esigenze aziendali.

**Topics**
+ [

## Crea profili dedotti e associa automaticamente profili (CTR-) NoInferred
](#ctr-contact-record-template-no-inferred)
+ [

## Associa automaticamente solo i profili (CTR-) AutoAssociateOnly
](#ctr-contact-record-template-auto-associate)
+ [

## Crea solo profili dedotti (CTR)
](#ctr-contact-record-template-inferred-only)
+ [

## Esempi di utilizzo del modello di record di contatto
](#ctr-contact-record-template-usage-examples)
+ [

## Come aggiornare il tipo Record di contatto nella console AWS
](#ctr-contact-record-template-usage-examples-console)
+ [

## Aggiungi automaticamente i nomi dai contatti e-mail a un profilo
](#add-email-names-to-profile)

## Crea profili dedotti e associa automaticamente profili (CTR-) NoInferred
<a name="ctr-contact-record-template-no-inferred"></a>

**Descrizione**

Quando si utilizza il NoInferred modello CTR- e si verifica un evento di contatto, ad esempio una telefonata, viene avviato un processo specifico per gestire i dati. Inizialmente, il sistema utilizza la chiave `_ctrContactId` per cercare un profilo esistente associato all'evento di contatto. Se viene trovato un profilo corrispondente, l'evento di contatto viene automaticamente associato a quel profilo. Tuttavia, se non viene trovato alcun profilo esistente utilizzando la chiave `_ctrContactId`, il sistema procede alla ricerca di un profilo utilizzando una chiave secondaria denominata `_phone`. Questa chiave viene utilizzata per individuare un profilo esistente in base al numero di telefono associato all'evento di contatto. Quando viene trovato un profilo corrispondente, l'evento di contatto viene automaticamente associato a quel profilo.

Nei casi in cui né la chiave `_ctrContactId` né la chiave `_phone` generino un profilo esistente, il sistema crea un nuovo profilo dedotto. Questo profilo dedotto viene quindi popolato con i metadati dell'evento di contatto, assicurando che le informazioni vengano acquisite e archiviate all'interno del sistema.

Questo processo garantisce una gestione efficiente degli eventi di contatto, promuove l'associazione automatica con i profili esistenti e consente la creazione di profili dedotti quando necessario. Sfruttando questi meccanismi, le organizzazioni possono mantenere un registro completo delle interazioni con i clienti e gestire efficacemente i dati relativi agli eventi di contatto all'interno del sistema.

Si consiglia di utilizzare il NoInferred modello CTR- come comportamento predefinito per i suoi vantaggi significativi, in particolare nella riduzione dei profili duplicati

![\[Il diagramma modello CTR di Contact Record. NoInferred\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/ctr-contact-record-template-no-inferred.png)


## Associa automaticamente solo i profili (CTR-) AutoAssociateOnly
<a name="ctr-contact-record-template-auto-associate"></a>

**Descrizione**

Il AutoAssociateOnly modello CTR funziona in modo simile al NoInferred modello CTR con un'importante distinzione: non crea un profilo dedotto quando non è possibile trovare alcun profilo esistente per l'associazione automatica.

Quando si verifica un evento di contatto, ad esempio una telefonata, il AutoAssociateOnly modello CTR- utilizza la `_ctrContactId` chiave per cercare un profilo esistente corrispondente. Se viene trovato un profilo, l'evento di contatto viene automaticamente associato a quel profilo.

Tuttavia, se non viene trovato alcun profilo esistente utilizzando la chiave `_ctrContactId`, il modello utilizza un meccanismo di ricerca secondario che utilizza la chiave `_phone`. Cerca un profilo esistente associato allo stesso numero di telefono dell'evento di contatto. Se viene trovato un profilo corrispondente, l'evento di contatto viene associato automaticamente a quel profilo.

Lo scopo dell'utilizzo del AutoAssociateOnly modello CTR- è consentire l'associazione automatica con i profili esistenti mantenendo un controllo rigoroso sulla creazione del profilo. A differenza del NoInferred modello CTR-, questo modello impedisce la creazione di profili dedotti quando non viene trovata alcuna corrispondenza. Garantisce che i profili vengano creati solo manualmente, fornendo alle organizzazioni un livello più elevato di controllo e precisione nella gestione dei profili.

Utilizzando il AutoAssociateOnly modello CTR-, le organizzazioni possono sfruttare l'associazione automatica rispettando al contempo regole specifiche relative alla creazione del profilo. Questo approccio consente una gestione semplificata degli eventi di contatto e un controllo preciso sull'ecosistema dei profili, garantendo una rappresentazione accurata dei dati e facilitando una gestione efficiente dei clienti.

![\[Il diagramma modello CTR di Contact Record. AutoAssociateOnly\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/ctr-contact-record-template-auto-associate.png)


## Crea solo profili dedotti (CTR)
<a name="ctr-contact-record-template-inferred-only"></a>

**Descrizione**

Il modello CTR si basa esclusivamente sulla chiave `_ctrContactId` per la ricerca di un profilo esistente e associa automaticamente l'evento di contatto al profilo se viene trovata una corrispondenza. Tuttavia, nei casi in cui non viene trovato alcun profilo esistente, il modello crea un profilo dedotto e lo popola con i metadati dell'evento di contatto.

Sebbene questo comportamento garantisca che gli eventi di contatto vengano acquisiti anche quando non esiste un profilo preesistente, può potenzialmente portare alla creazione di numerosi profili dedotti. Questa abbondanza di profili dedotti può portare alla creazione di profili duplicati all'interno del sistema.

Per risolvere questo problema e promuovere migliori pratiche di gestione dei profili, consigliamo vivamente di utilizzare il NoInferred modello CTR- come opzione predefinita. Utilizzando il NoInferred modello CTR-, il sistema elimina la creazione di profili dedotti, riducendo così la presenza di profili duplicati. Questo modello consente una gestione più ottimizzata ed efficiente degli eventi di contatto, con conseguente miglioramento dell'integrità e della precisione dei dati.

Adottando il NoInferred modello CTR come scelta predefinita, le organizzazioni possono ottimizzare i processi di gestione dei profili, ridurre al minimo la duplicazione dei dati e garantire una rappresentazione più affidabile delle interazioni con i clienti.

![\[Il diagramma modello CTR di Contact Record.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/ctr-contact-record-template-inferred-only.png)


## Esempi di utilizzo del modello di record di contatto
<a name="ctr-contact-record-template-usage-examples"></a>

**Amazon Connect sito web di amministrazione**
+ Nel sito web di Amazon Connect amministrazione, quando crei un nuovo dominio, hai la possibilità di selezionare il comportamento CTR desiderato. Ciò può essere fatto tramite le opzioni del pulsante di opzione disponibili nella sezione **Creazione del profilo e associazione automatica**. Allo stesso modo, quando si seleziona un dominio esistente, l'opzione del pulsante di opzione riflette il comportamento precedentemente associato a quel dominio.
+ Quando si modifica un dominio attualmente abilitato, la pagina dei dettagli del dominio mostrerà il comportamento attualmente applicato nella sezione **Creazione del profilo e associazione automatica**. Scegliendo il pulsante **Modifica** nell'intestazione di questa sezione, vieni reindirizzato alla pagina **Modifica** **creazione del profilo e associazione automatica**. Qui è possibile scegliere un comportamento diverso in base alle specifiche esigenze di lavoro.
+ In alternativa, se si stai utilizzando la mappatura CTR dalla pagina **Mappatura dei dati**, è possibile scegliere il pulsante **Cambia modello**. Questa azione ti porterà anche alla pagina di **creazione del profilo e associazione automatica** di **Modifica**, dove è possibile selezionare un comportamento diverso adatto alle esigenze.

Queste opzioni offrono flessibilità nella gestione del comportamento CTR per domini, consentendoti di personalizzare e modificare facilmente le impostazioni in base alle tue preferenze specifiche o ai requisiti aziendali in evoluzione.

**AWS CLI**
+ Per utilizzare il NoInferred modello **CTR-**, esegui il seguente comando sulla CLI:

  `aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "Creates inferred profiles and auto-associates profiles" --template-id CTR-NoInferred `
+ Per utilizzare il AutoAssociateOnly modello **CTR-**, esegui il seguente comando sulla CLI:

  `aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "Auto-associate with profiles only" --template-id CTR-AutoAssociateOnly `
+ Per utilizzare il modello **CTR**, esegui il seguente comando sulla CLI:

  `aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "Creates inferred profiles only" --template-id CTR `

**API**

Per informazioni sull'utilizzo dell'API, consulta [PutProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_PutProfileObjectType.html)

## Come aggiornare il tipo Record di contatto nella console AWS
<a name="ctr-contact-record-template-usage-examples-console"></a>

1. Nella console Profili dei clienti, seleziona **Visualizza dettagli** nella sezione **dominio Profili dei clienti**.  
![\[Scegli Visualizza dettagli nella sezione del dominio Profili dei clienti\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/ctr-contact-record-template-usage-examples-console-1.png)

1. Nella pagina dei **Dettagli del dominio**, scegli **Modifica** nella sezione **Creazione del profilo e associazione automatica**.  
![\[Scegli Modifica nella sezione Creazione del profilo e associazione automatica.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/ctr-contact-record-template-usage-examples-console-2.png)

1. Seleziona il comportamento del Record di contatto desiderato da applicare al tuo dominio e scegli **Salva**.  
![\[Seleziona il comportamento del Record di contatto desiderato da applicare al tuo dominio e scegli Salva.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/ctr-contact-record-template-usage-examples-console-3.png)

## Aggiungi automaticamente i nomi dai contatti e-mail a un profilo
<a name="add-email-names-to-profile"></a>

Puoi impostare un flusso per inserire il nome di un contatto e-mail nel profilo del cliente. Utilizza il blocco [Profili dei clienti](customer-profiles-block.md), configurato per utilizzare l’azione [Aggiorna profilo](customer-profiles-block.md#customer-profiles-block-properties-update-profile). 

# Associa automaticamente il Record di contatto a un profilo trovato utilizzando il tasto \$1phone in Profili dei clienti
<a name="auto-associate-profile-using-phone-profile-key"></a>

È possibile associare automaticamente il record del contatto a un profilo trovato utilizzando la chiave `_phone`.

**Esempio**

Nel dominio, l'API `CreateProfile` crea il seguente profilo:

```
            {
                "FirstName": "John",
                "LastName": "Doe",
                "PhoneNumber": "+11234567890"
            }
```

Quando si riceve una chiamata dal `PhoneNumber` \$111234567890 utilizzando il modello CTR predefinito, il record di contatto non verrà associato automaticamente al profilo precedente a meno che un agente non abbia già associato manualmente il record di contatto allo stesso chiamante al profilo precedente. Se il record di contatto non viene associato manualmente o automaticamente, i profili dei clienti creano un profilo dedotto con le informazioni del record di contatto.

Per associare automaticamente il profilo precedente ai record di contatto senza l'intervento manuale dell'agente, puoi utilizzare il NoInferred modello CTR-. Quando si riceve una chiamata dal numero `PhoneNumber` \$111234567890 utilizzando il NoInferred modello CTR-, il record del contatto si assocerà automaticamente al profilo precedente utilizzando la chiave del profilo. `_phone`

Esistono due scenari in cui *non* sarà possibile associare automaticamente i record di contatto a un profilo con Profili cliente:
+ Se viene trovato più di un profilo utilizzando la chiave del profilo `_phone`, è impossibile associare il record di contatto a un profilo univoco in Profili cliente e la richiesta viene rifiutata.
+ Se non viene trovato alcun profilo per la chiave del profilo `_phone`, tramite Profili cliente viene creato un profilo dedotto.

Per utilizzare il modello CTR- per sostituire il NoInferred modello CTR predefinito, esegui il seguente comando sulla CLI:

`aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "No inferred contact record profiles" --template-id CTR-NoInferred`

Per ripristinare il comportamento predefinito, esegui il comando seguente nella CLI:

`aws customer-profiles put-profile-object-type --domain-name {domain} --object-type-name CTR --description "Revert to inferred contact record profiles" --template-id CTR`

# Esempi di mappature del tipo di oggetto in Amazon Connect Customer Profiles
<a name="examples-object-type-mappings"></a>

## Una mappatura dei tipi di oggetto che genera un profilo
<a name="profile-generating-example"></a>

L'esempio seguente mostra i dati che popolano il profilo standard.

Di seguito è riportato l'oggetto in arrivo:

```
{
  "account": 1234,
  "email": "john@examplecorp.com",
  "address": {
     "address1": "Street",
     "zip": "Zip",
     "city": "City"
  },
  "firstName": "John",
  "lastName": "Doe"
}
```

Il codice seguente mostra la mappatura degli oggetti in entrata in un oggetto del profilo standard e l'indicizzazione `PersonalEmailAddress`, `fullName` e `accountId`, che è una chiave univoca.

```
{
    "Fields": {
        "accountId": {
            "Source": "_source.account",
            "Target": "_profile.AccountNumber",
            "ContentType": "NUMBER"
        },
        "shippingAddress.address1": {
            "Source": "_source.address.address1",
            "Target": "_profile.ShippingAddress.Address1"
        },
        "shippingAddress.postalCode": {
            "Source": "_source.address.zip",
            "Target": "_profile.ShippingAddress.PostalCode"
        },
        "shippingAddress.city": {
            "Source": "_source.address.city",
            "Target": "_profile.ShippingAddress.City"
        },
        "personalEmailAddress": {
            "Source": "_source.email",
            "Target": "_profile.PersonalEmailAddress",
            "ContentType": "EMAIL_ADDRESS"
        },
        "fullName": {
            "Source": "{{_source.firstName}} {{_source.lastName}}"
        },
        "firstName": {
            "Source": "_source.firstName",
            "Target": "_profile.FirstName"
        },
        "lastName": {
            "Source": "_source.lastName",
            "Target": "_profile.LastName"
        }
    },
    "Keys": {
        "_email": [
            {
                "FieldNames": ["personalEmailAddress"]
            }
        ],
        "_fullName": [
            {
                "FieldNames": ["fullName"]
            }
        ],
        "_account": [
            {
                "StandardIdentifiers": ["PROFILE","UNIQUE"],
                "FieldNames": ["accountId"]
            }
        ]
    }
}
```

Nota che `email` e `fullname` sono indicizzati, ma non vengono utilizzati per cercare il profilo. L'account è la chiave univoca. È necessario specificare l'oggetto. Ogni volta che viene inserito un oggetto con lo stesso ID account, sovrascrive l'oggetto precedente con lo stesso ID account.

Nell'oggetto del profilo standard vengono popolati diversi campi (vedi i campi che sono stati definiti `Target`).

## Una mappatura dei tipi di oggetto che non popola il profilo standard
<a name="ticket-issue-example"></a>

Questo esempio mostra un caso d'uso più complicato. Acquisisce i dati relativi a un profilo ma non popola necessariamente l'oggetto del profilo standard.

Di seguito è riportato l'oggetto in arrivo:

```
{
  "email": "john@examplecorp.com",
  "timestamp": "2010-01-01T12:34:56Z",
  "subject": "Whatever this is about",
  "body": "Body of ticket"
}
```

Di seguito è riportato un modo per mappare questi dati:

```
{
    "Fields": {
        "email": {
            "Source": "_source.email",
            "ContentType": "EMAIL_ADDRESS"
        },
        "timestamp": {
            "Source": "_source.timestamp"
        }
    },
    "Keys": {
        "_email": [
            {
                "StandardIdentifiers": ["PROFILE","LOOKUP_ONLY"],
                "FieldNames": ["email"]
            }
        ],
        "ticketEmail": [
            {
                "StandardIdentifiers": ["PROFILE","SECONDARY","NEW_ONLY"],
                "FieldNames": ["email"]
            }
        ],
        "uniqueTicket": [
            {
                "StandardIdentifiers": ["UNIQUE"],
                "FieldNames": ["email","timestamp"]
            }
        ]
    }
}
```

Questo esempio importa i dati e, alla prima ricerca, importa l'indirizzo e-mail. 
+ Se l'indirizzo e-mail corrisponde a un profilo singolo, viene utilizzato per allegare i dati a quel profilo specifico. L'identificatore univoco del ticket è composto dall'e-mail e dal timestamp poiché non esiste nessun altro identificatore univoco.
+ Se non esiste alcun profilo con l'e-mail specificata, viene creato un nuovo profilo con il campo singolo `EmailAddress` compilato. L'oggetto importato è allegato a questo nuovo **profilo dedotto**. Le due chiavi ricercabili che possono trovare il profilo sono `_email` e `uniqueTicket`.
+ Se esiste più di un profilo con l'indirizzo e-mail specificato, viene creato un nuovo profilo con il campo singolo `EmailAddress` compilato e l'oggetto viene allegato a questo nuovo profilo. Questo profilo viene creato con la chiave definita `ticketEmail`, oltre a `_email` e `uniqueTicket`. Tutti i ticket successivi provenienti da quell'e-mail vengono assegnati a questo nuovo **profilo dedotto**. Il motivo è che la chiave ` _email` si riferisce a tre profili e quindi viene scartata, tuttavia la chiave `ticketEmail` si riferisce solo a un singolo profilo (quello nuovo dedotto) ed è ancora valida.
+ Nei casi in cui viene creato un nuovo **profilo dedotto**, il campo `EmailAddress` viene popolato dal primo oggetto che lo ha creato.

# Tipi di oggetto del profilo implicito in Amazon Connect Customer Profiles
<a name="implicit-profile-object-types"></a>

È possibile utilizzare qualsiasi tipo di oggetto che corrisponda al nome di un ID modello (restituito dall'[ListProfileObjectTypeTemplates](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjectTypeTemplates.html)API) senza definirlo in modo esplicito. Il tipo di oggetto corrisponderà esattamente alla definizione del modello di questo tipo di oggetto. Se viene definito un tipo di oggetto esplicito, sostituisce quello implicito. 

I tipi di oggetti impliciti sono inclusi nell'[ListProfileObjectTypes](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_ListProfileObjectTypes.html)API o restituiti dalle [GetProfileObjectType](https://docs.aws.amazon.com/customerprofiles/latest/APIReference/API_GetProfileObjectType.html)operazioni, ma possono comunque essere eliminati se si desidera rimuovere tutti i dati acquisiti da quel tipo di oggetto.

# Mappatura dei dati basata sull’IA generativa in Amazon Connect
<a name="genai-powered-data-mapping"></a>

Amazon Connect Customer Profiles offre una funzionalità generativa di mappatura dei dati dei clienti basata sull'intelligenza artificiale che riduce significativamente il tempo necessario per creare profili unificati, consentendoti di contribuire a fornire esperienze clienti più personalizzate.

Grazie a questa funzionalità, quando gli amministratori dei contact center aggiungono i dati dei clienti da uno degli oltre 70 connettori dati senza codice disponibili come Adobe Analytics, Salesforce o Amazon Simple Storage Service (S3) Amazon Connect , Customer Profiles analizzerà i dati provenienti da queste fonti per determinare automaticamente come organizzare e combinare i dati esistenti in formati diversi da fonti diverse in profili unificati in profili unificati in. Amazon Connect Gli amministratori dei contact center possono esaminare e completare la configurazione dei profili dei clienti, in modo da fornire agli agenti le informazioni pertinenti sui clienti IVRs e personalizzare dinamicamente i chatbot per migliorare la soddisfazione dei clienti e la produttività degli agenti.

La mappatura dei dati dei clienti basata sull'IA generativa è disponibile nelle seguenti regioni:
+ Stati Uniti orientali (Virginia settentrionale)
+ Stati Uniti occidentali (Oregon)
+ Africa (Città del Capo)
+ Asia Pacifico (Singapore)
+ Asia Pacifico (Sydney)
+ Asia Pacifico (Tokyo)
+ Asia Pacifico (Seul)
+ Canada (Centrale)
+ Europa (Francoforte)
+ Europa (Londra)

## Configurazione della mappatura dei dati basata sull'IA generativa
<a name="set-up-genai-powered-data-mapping"></a>

1. Apri la console Customer Profiles. Amazon Connect 

1. Nella scheda **Integrazioni di origini dati**, scegli **Aggiungi integrazione dell'origine dati**.

1. Configura la connessione. Seleziona l'origine dati dal menu a discesa in cui sono disponibili tutti i connettori supportati.  
![\[Seleziona l'origine dati dal menu a discesa in cui sono disponibili tutti i connettori supportati.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/genai-augmented-data-mapping-1.png)

1. Esegui la mappatura dei dati. Seleziona l'opzione per generare automaticamente la mappatura dei dati oppure seleziona un modello di mappatura già esistente o creane uno da zero.  
![\[Esegui la mappatura dei dati. Seleziona l'opzione per generare automaticamente la mappatura dei dati oppure seleziona un modello di mappatura già esistente o creane uno da zero.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/genai-augmented-data-mapping-2.png)

1. Rivedi il riepilogo della mappatura. Rivedi il riepilogo dei risultati di mappatura generato automaticamente che mostra tutti gli attributi dei clienti. Apporta modifiche alle chiavi di importazione e conferma prima di avviare l'importazione dei dati. Per ulteriori informazioni sulle mappature dei campi e sulle chiavi, consulta [Dettagli della definizione di mappatura dei tipi di oggetto in Amazon Connect Customer Profiles](object-type-mapping-definition-details.md).  
![\[Rivedi il riepilogo della mappatura. Rivedi il riepilogo dei risultati di mappatura generato automaticamente che mostra tutti gli attributi dei clienti. Apporta modifiche alle chiavi di importazione e conferma prima di avviare l'importazione dei dati.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/genai-augmented-data-mapping-3.png)

## Come funziona
<a name="genai-powered-data-mapping-how-it-works"></a>

Il sistema funziona in quattro fasi. Nella prima fase, Profili cliente recupera gli attributi di origine e, se disponibili, campiona i dati dall'origine dati, determinando successivamente il tipo di oggetto più appropriato per la destinazione. Per un'origine dati Amazon S3, come dati di esempio verrà utilizzato il primo file CSV trovato nel bucket e nel prefisso Amazon S3 selezionati. Per altre fonti di dati, Customer Profiles recupera gli attributi di origine tramite AppFlow. Nella seconda fase, viene sfruttato un modello linguistico di grandi dimensioni (LLM) per elaborare ulteriormente ciascuno degli attributi personalizzati e mapparli agli attributi standard del profilo del cliente. LLM viene nuovamente utilizzato nella terza fase per selezionare gli attributi idonei che possono fungere da chiavi, come gli identificatori del cliente. Infine, nella quarta fase, il rilevatore del formato timestamp analizza i timestamp per mantenere l'ordine cronologico dei record. Il sistema è in grado di generare la mappatura per un massimo di 120 attributi in meno di 20 secondi dopo aver combinato i risultati della previsione.

## Risoluzione dei problemi di mappatura dei dati basata sull'IA generativa
<a name="genai-powered-data-mapping-troubleshooting"></a>

Le seguenti sezioni mostrano i possibili messaggi di errore che potresti riscontrare. Fornisce inoltre la causa e la risoluzione di ogni problema.

### Errore: impossibile analizzare la stringa dell'oggetto in JSON
<a name="genai-powered-data-mapping-parse-object-error"></a>

La stringa dell'oggetto nella richiesta non è un JSON valido. Rivedi la stringa dell'oggetto nella richiesta e verifica che sia un JSON valido.

### Errore: il valore 'objects' non è riuscito a soddisfare il vincolo; il membro deve avere un valore minore o uguale a 5
<a name="genai-powered-data-mapping-failed-constraint-error"></a>

Sono presenti troppi oggetti nella richiesta. In una richiesta sono consentiti fino a cinque oggetti. Riduci il numero di oggetti a un massimo di cinque.

### Errore: è stato violato il limite di 120 attributi
<a name="genai-powered-data-mapping-breached-limit"></a>

In un oggetto JSON sono consentiti fino a 120 attributi, inclusi gli attributi JSON nidificati. Rimuovi alcuni attributi che non devono essere mappati dall'oggetto JSON.

![\[In un oggetto JSON sono consentiti fino a 120 attributi, inclusi gli attributi JSON nidificati. Rimuovi alcuni attributi che non devono essere mappati dall'oggetto JSON.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/genai-augmented-data-mapping-breached-limit.png)


### Attenzione: impossibile trovare una **chiave univoca**, che distingua i dati. Impossibile trovare una **chiave profilo**, che identifichi i profili.
<a name="genai-powered-data-mapping-unique-key-warning"></a>

Il modello non è stato in grado di trovare un tipo di oggetto valido dall'oggetto specificato. Modifica l'input o utilizza l'approccio di mappatura manuale come suggerito.

![\[Il modello non è stato in grado di trovare un tipo di oggetto valido dall'oggetto specificato. Modifica l'input o utilizza l'approccio di mappatura manuale come suggerito.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/genai-augmented-data-mapping-unique-key-warning.png)


# Limiti di dati di Amazon Connect Customer Profiles
<a name="customer-profiles-data-limits"></a>

Amazon Connect Customer Profiles ti consente di personalizzare l’onboarding dei dati impostando limiti di importazione dei dati su vari tipi di dati dei clienti utilizzati per creare un profilo unificato. L’impostazione dei limiti alle mappature dei dati ti consente di dare la priorità alla quantità di dati da importare tra le mappature. Il limite massimo predefinito per tutte le mappature per profilo è 1000.

**Nota**  
I limiti di dati sono stime e possono variare leggermente, con una possibile deviazione di alcune unità in entrambe le direzioni durante i periodi di elevata importazione su un singolo profilo.

## Come configurare i limiti dei dati di Profili dei clienti
<a name="customer-profiles-data-limits-configure"></a>

1. Apri la console Customer Profiles. Amazon Connect 

1. Scegli la scheda **Limiti dei dati** per configurare i limiti per gli oggetti di dati.  
![\[Vai alla scheda Limiti dei dati per configurare i limiti per gli oggetti di dati.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-data-limits-setup-1.png)

1. Passa il mouse sul limite dell’oggetto dati desiderato e scegli l’icona di modifica.  
![\[Passa il mouse sul limite dell’oggetto dati desiderato e scegli l’icona di modifica.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-data-limits-setup-2.png)

1. Inserisci il limite e scegli l’icona del segno di spunta per salvare o aggiornare il limite.  
![\[L’immagine mostra l’inserimento di un nuovo limite ed evidenzia l’icona del segno di spunta utilizzata per salvare o aggiornare il limite.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-data-limits-setup-3.png)

## Come cancellare i limiti relativi ai dati di Profili dei clienti
<a name="customer-profiles-data-limits-clear"></a>

1. Seleziona il pulsante di opzione per l’oggetto dati di cui desideri cancellare il limite. Potrai quindi scegliere **Cancella limite**.  
![\[Evidenzia il pulsante di opzione a sinistra dell’oggetto dati nella pagina Limiti dei dati. Selezionando qui un pulsante di opzione è possibile abilitare il pulsante di cancellazione per un limite dei dati dell’oggetto.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-data-limits-clear-1.png)

1. Digita *conferma* per cancellare il valore limite dell’oggetto dati selezionato.  
![\[Una finestra pop-up che ti chiede di confermare che desideri cancellare il valore limite dell’oggetto dati. Confermi l’azione di cancellazione digitando “conferma” in lettere tutte minuscole.\]](http://docs.aws.amazon.com/it_it/connect/latest/adminguide/images/customer-profiles-data-limits-clear-2.png)