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à.
Imposta l'esportazione in blocco per tutti i dati unificati del tuo profilo cliente
Nota
Per completare i passaggi descritti in questo argomento, è necessario disporre di competenze da sviluppatore ed avere esperienza nell'uso AWS KMS di Amazon S3.
Quando Amazon Connect Customer Profiles crea un profilo cliente unificato, migliora, perfeziona e migliora i dati e le informazioni non elaborati in un profilo più accurato combinando dati provenienti da fonti proprietarie e di terze parti. Customer Profiles migliora anche la qualità dei set di dati attraverso l'aggiunta di nuovi dati. È possibile utilizzare i set di dati migliorati per ulteriori casi d'uso, ad esempio per formulare strategie di marketing, vendita e assistenza clienti più informate e mirate. Ad esempio, potresti voler sfruttare il profilo cliente unificato per:
-
Controlla i dati dei clienti che hai nell'intero dominio.
-
Esegui analisi interne, ad esempio, per report di vendita e marketing.
-
Esporta i dati nei tuoi strumenti o in prodotti di terze parti, per personalizzare gli annunci e rivolgerti ai clienti.
Per sfruttare i dati unificati del profilo cliente per altri casi d'uso, puoi esportarli in blocco su Amazon S3. Questo argomento spiega come eseguire questa operazione.
Indice
Passaggio 1: configura una chiave KMS e un bucket S3
Per abilitare l'esportazione in blocco per il tuo dominio, devi configurare le seguenti risorse:
Questi passaggi vengono spiegati di seguito.
Crea una nuova chiave KMS o riutilizza una chiave KMS esistente
Per configurare una chiave KMS per l'esportazione in blocco, devi creare o riutilizzare una chiave KMS esistente che si trova nella stessa AWS regione del bucket Amazon S3 che intendi configurare come destinazione di esportazione di massa. Devi consentire al AppIntegrations servizio Amazon Connect di eseguire azioni KMS per la chiave.
Aggiungi la seguente dichiarazione alla tua politica chiave.
Configura un bucket di destinazione S3
Devi configurare un bucket nuovo o esistente nella stessa AWS regione della chiave KMS e configurare una politica delle risorse sul bucket S3.
Durante la configurazione del bucket, assicurati di selezionare Encryption with SSE-KMS e di utilizzare la stessa chiave KMS della procedura precedente. Inoltre, non abilitarlo sul bucket S3. ACLs
Di seguito è riportato un esempio di politica delle risorse.
Fase 2: Creare un processo di esportazione in blocco
Per creare un processo di esportazione in blocco, richiami il seguente Amazon Connect: AppIntegrations APIs
-
CreateDataIntegration: questa API crea un'integrazione con la fonte di dati (ad esempio, Customer Profiles).
-
CreateDataIntegrationAssociation: Questa API scrive i dati nella destinazione (ad esempio, un bucket S3) utilizzando l'origine dati.
Di seguito sono riportate ulteriori informazioni su come chiamarli. APIs
Crea un'integrazione dei dati
Un'integrazione dei dati rappresenta la fonte dei dati. Puoi chiamare l'CreateDataIntegrationAPI o eseguire il comando create-data-integrationCLI per creare un'integrazione dei dati. È necessario fornire un tipo di oggetto Customer Profiles e un dominio Customer Profiles.
Se desideri esportare più tipi di oggetti, devi creare un'integrazione dei dati separata per ognuno di essi. Ad esempio, se desideri esportare _profile sia _asset oggetti che oggetti, devi creare due integrazioni di dati separate.
Nota
I dati inseriti negli ultimi 30 minuti potrebbero non essere inclusi nell'esportazione.
L'esempio di codice seguente mostra come eseguire il comando create-data-integrationCLI.
aws appintegrations create-data-integration \ --region "us-west-2" \ --name "bulk-export-job-01" \ --description "Data integration for _profile objects" \ --kms-key "arn:aws:kms:us-west-2:123456789012:key/123456789012-1234-1234-123456789012" \ --source-uri "AmazonConnect://AppIntegrations" \ --object-configuration '{"CustomerProfiles":{"domainName":["my-domain-pdx"],"objectType":["_profile"]}}'
Il seguente esempio di codice mostra come chiamare l'CreateDataIntegrationAPI.
{ "Description": "Data integration for _profile objects", "KmsKey": "arn:aws:kms:us-west-2:123456789012:key/123456789012-1234-1234-123456789012", "Name": "unique-data-integration-name-01", "SourceURI": "AmazonConnect://AppIntegrations", "ObjectConfiguration": { "CustomerProfiles": { "domainName": [ "my-domain-pdx" ], "objectType": [ "_profile" ] } } }
Creare un'associazione di integrazione dei dati
Un'associazione di integrazione dei dati rappresenta la destinazione in cui esportare i dati e un intervallo di tempo per la scelta dei dati da esportare. Puoi chiamare l'CreateDataIntegrationAssociationAPI o eseguire il comando create-data-integration-associationCLI per creare un'integrazione dei dati. È possibile configurare l'intervallo di tempo utilizzando le EndTime proprietà StartTime and. Questo intervallo di tempo corrisponde all'ultimo aggiornamento degli oggetti nei profili dei clienti.
Il bucket S3 di destinazione che specifichi può essere solo il nome del bucket oppure può includere una cartella aggiuntiva o un prefisso S3 in cui desideri che i dati vengano esportati.
Nota
Per la quota per i lavori di esportazione simultanea in blocco, vedi. Amazon Connect Quote di servizio Customer Profiles Dopo il completamento o l'esito negativo di un processo di esportazione in blocco, non viene più conteggiato ai fini della quota di concorrenza.
L'esempio di codice seguente mostra come eseguire il comando create-data-integration-associationCLI.
aws appintegrations create-data-integration-association \ --region "us-west-2" \ --data-integration-identifier "unique-data-integration-name-01" \ --destination-uri "s3://" \ --execution-configuration 'amzn-s3-demo-bucket1{"ExecutionMode": "ON_DEMAND", "OnDemandConfiguration": {"StartTime":"1715278292014", "EndTime":"1715364692014"}}'
Il seguente esempio di codice mostra come chiamare l'CreateDataIntegrationAssociationAPI.
{ "DataIntegrationIdentifier": "arn:aws:app-integrations:us-west-2:123456789012:data-integration/123456789012-1234-1234-123456789012", "DestinationURI": "s3://amzn-s3-demo-bucket1", "ExecutionConfiguration": { "ExecutionMode": "ON_DEMAND", "OnDemandConfiguration": { "StartTime": "1713565000004", "EndTime": "1713565000005" } } }
Fase 3: Verificare lo stato di un processo di esportazione in blocco
Per visualizzare lo stato del tuo processo di esportazione in blocco, puoi chiamare l'ListDataIntegrationAssociationsAPI o eseguire il comando list-data-integration-associationsCLI.
L'esempio di codice seguente mostra come eseguire il comando list-data-integration-associationsCLI.
aws appintegrations list-data-integration-associations \ --region "us-west-2" \ --data-integration-identifier "unique-data-integration-name-01"
Passaggio 4: Visualizza i dati esportati in S3
Quando l'associazione di integrazione dei dati è attivaIN_PROGRESS, inizierai a vedere i dati copiati nel tuo bucket S3.
I dati esportati vengono scritti utilizzando la seguente struttura di percorsi:
-
{BucketNameAndFolderName}
-
{AwsAccountId}
-
{DomainName}
-
{RequestTimestamp}
-
{lStartTime}-{EndTime}
-
{ObjectTypeName}
-
<filename: uuid>
-
-
-
-
-
-
Di seguito è riportato un percorso di esempio:
amzn-s3-demo-bucket1/123456789012/my-domain-pdx/20240607T175023/20240101T235959-20240430T235959/_profile/123456789012-1234-1234-123456789012
Aggiornate il processo di esportazione in blocco
Al termine del processo, puoi aggiornare l'associazione di integrazione dei dati con un'ora di inizio del data pull e un'ora di fine del data pull diversi. Questo crea un nuovo processo di esportazione in blocco. Questa operazione può essere utile se in passato hai eseguito un'esportazione in blocco e desideri esportare solo i dati che sono stati aggiornati dopo l'esportazione precedente. Ad esempio, se il tuo ultimo processo di esportazione in blocco risale a tre mesi fa, puoi aggiornare l'associazione di integrazione dei dati con un intervallo di tempo compreso tra 3 mesi fa e oggi.
Puoi chiamare l'UpdateDataIntegrationAssociationAPI o eseguire il comando update-data-integration-associationCLI per aggiornare il processo di esportazione.
L'esempio di codice seguente mostra come eseguire il comando update-data-integration-associationCLI.
aws appintegrations update-data-integration-association \ --region "us-west-2" \ --data-integration-identifier "unique-data-integration-name-01" \ --data-integration-association-identifier "arn:aws:app-integrations:us-west-2:123456789012:data-integration-association/123456789012-1234-1234-123456789012/123456789012-1234-1234-123456789012" \ --execution-configuration '{"ExecutionMode": "ON_DEMAND", "OnDemandConfiguration": {"StartTime":"1715278292014", "EndTime":"1715364692014"}}'
Eliminare o annullare il processo di esportazione in blocco, operazione non supportata
Non è possibile eliminare o annullare l'esportazione in blocco. Al termine di un processo di esportazione, non viene più conteggiato ai fini della quota di esportazione.
