Impostazione dell’esportazione in blocco per tutti i dati unificati del profilo cliente - Amazon Connect
Fase 1: impostare una chiave KMS e un bucket S3Fase 2: creare un processo di esportazione in bloccoFase 3: controllare lo stato di un processo di esportazione in bloccoFase 4: visualizzare dati esportati in S3Aggiornare il processo di esportazione in bloccoEliminare o annullare il processo di esportazione in blocco: operazione non supportata

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à.

Impostazione dell’esportazione in blocco per tutti i dati unificati del 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 origini proprietarie e di terze parti. Profili dei clienti migliora inoltre la qualità dei set di dati tramite 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, è possibile sfruttare il profilo cliente unificato per:

  • Controllare i dati dei clienti presenti nell’intero dominio.

  • Eseguire analisi interne, ad esempio, per report di vendita e marketing.

  • Esportare 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. In questo argomento viene spiegato come eseguire questa operazione.

Fase 1: impostare una chiave KMS e un bucket S3

Per abilitare l’esportazione in blocco per il dominio, è necessario configurare le seguenti risorse:

Questi passaggi vengono spiegati in seguito.

Creazione di una nuova chiave KMS del servizio di gestione delle chiavi esistenti

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 policy della chiave.

JSON
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "Enable AppIntegrations access to KMS key",
            "Effect": "Allow",
            "Principal": {
                "AWS": [
                    "arn:aws:iam::111122223333:root"
                ],
                "Service": [
                    "app-integrations.amazonaws.com"
                ]
            },
            "Action": [
                "kms:Encrypt*",
                "kms:Describe*",
                "kms:Decrypt*",
                "kms:GenerateDataKey*"
            ],
            "Resource": "*"
        }
    ]
}

Configurazione di 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 Crittografia con SSE-KMS e di utilizzare la stessa chiave KMS della procedura precedente. Inoltre, non abilitarla ACLs sul bucket S3.

Di seguito viene riportato un esempio della policy delle risorse.

JSON
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "Allow AppIntegrations to write data to destination bucket",
            "Effect": "Allow",
            "Principal": {
                 "Service": [
                    "app-integrations.amazonaws.com"
                ]
            },
            "Action": [
                "s3:GetObject",
                "s3:ListBucket",
                "s3:PutObject",
                "s3:PutObjectAcl"
            ],
            "Resource": [
                "arn:aws:s3:::{{amzn-s3-demo-bucket1}}",
                "arn:aws:s3:::{{amzn-s3-demo-bucket2}}/*"
            ],
            "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "{{AwsAccountId}}"
                },
                "ArnEquals": {
                    "aws:SourceArn": "arn:aws:*-*:{us-east-1}:{{AwsAccountId}}:data-integration/*" 
                }
            }
        }
    ]
}

Fase 2: creare un processo di esportazione in blocco

Per creare un processo di esportazione in blocco, richiami il seguente Amazon Connect: AppIntegrations APIs

  1. CreateDataIntegration: Questa API crea un'integrazione con la fonte di dati (ad esempio, Customer Profiles).

  2. 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

Creazione di un’integrazione dei dati

Un’integrazione dei dati rappresenta l’origine dati 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 Profili dei clienti e un dominio Profili dei clienti.

Se desideri esportare più tipi di oggetti, devi creare un’integrazione dei dati separata per ciascuno di essi. Ad esempio, se desideri esportare gli oggetti _profile e _asset, devi creare due integrazioni di dati separate.

Nota

I dati importati 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"
            ]
        }
    }
}

Creazione di 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 proprietà StartTime e EndTime. Questo intervallo di tempo corrisponde all’ultimo aggiornamento degli oggetti in Profili dei clienti.

Il bucket S3 di destinazione specificato può essere solo il nome del bucket oppure può includere una cartella aggiuntiva o un prefisso S3 in cui desideri esportare i dati.

Nota

Per la quota dei Processi di esportazione simultanei, consulta Amazon Connect Quote di servizio Customer Profiles. Una volta completato o non riuscito, un processo di esportazione in blocco non viene più conteggiato ai fini della quota di processi simultanei.

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://amzn-s3-demo-bucket1" \
--execution-configuration '{"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: controllare 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"

Fase 4: visualizzare dati esportati in S3

Quando l’associazione di integrazione dei dati è attiva in IN_PROGRESS, inizierai a vedere i dati copiati nel bucket S3.

I dati esportati vengono scritti utilizzando la seguente struttura di percorso:

  • {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

Aggiornare il processo di esportazione in blocco

Al termine del processo, puoi aggiornare l’associazione di integrazione dei dati con diverse ore di inizio e di fine di un data pull. Questa azione crea un nuovo processo di esportazione in blocco. Può essere utile se in passato hai eseguito un’esportazione in blocco e desideri esportare solo i dati che sono stati aggiornati dall’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. Dopo che un processo di esportazione termina, non viene più conteggiato ai fini della quota di esportazione.