Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Configurez l’exportation groupée pour toutes vos données de Profils des clients unifiées

Lorsque Profils des clients Amazon Connect crée un profil client unifié, il améliore, affine et améliore les données et informations brutes pour obtenir un profil plus précis en combinant des données provenant de sources internes et tierces. La fonctionnalité Profils des clients améliore également la qualité des jeux de données grâce à l’ajout de nouvelles données. Vous pouvez utiliser les jeux de données améliorés pour d’autres cas d’utilisation, par exemple pour formuler des stratégies de marketing, de vente et de service client plus informées et ciblées. Par exemple, vous pouvez tirer parti du profil client unifié pour :

Pour exploiter les données de profil client unifiées pour d’autres cas d’utilisation, vous pouvez les exporter en masse vers Amazon S3. Cette rubrique explique comment procéder.

Étape 1 : configurer une clé KMS et le compartiment S3

Pour activer l’exportation groupée pour votre domaine, vous devez configurer les ressources suivantes :

Ces étapes sont expliquées ci-dessous.

Création d’une nouvelle clé KMS ou réutilisation d’une clé KMS existante

Pour configurer une clé KMS pour l'exportation en masse, vous devez créer ou réutiliser une clé KMS existante qui se trouve dans la même AWS région que le compartiment Amazon S3 que vous prévoyez de configurer comme destination d'exportation en bloc. Vous devez autoriser le AppIntegrations service Amazon Connect à effectuer des actions KMS pour la clé.

Ajoutez la déclaration suivante à la stratégie de clé.

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": "*"
        }
    ]
}

Configuration d’un compartiment Amazon S3

Vous devez configurer un compartiment nouveau ou existant dans la même AWS région que la clé KMS, et configurer une politique de ressources sur le compartiment S3.

Lors de la configuration du compartiment, assurez-vous de sélectionner Chiffrement avec SSE-KMS et d’utiliser la même clé KMS que lors de la procédure précédente. En outre, ne l'activez pas ACLs sur le compartiment S3.

Voici un exemple de stratégie de ressources.

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/*" 
                }
            }
        }
    ]
} 

Étape 2 : créer une tâche d’exportation groupée

Pour créer une tâche d'exportation groupée, vous devez appeler l'Amazon Connect suivant AppIntegrations APIs :

Vous trouverez ci-dessous plus d'informations sur la façon de les appeler APIs.

Création d’une intégration des données

Une intégration de données représente la source de données de vos données. Vous pouvez appeler l'CreateDataIntegrationAPI ou exécuter la commande create-data-integrationCLI pour créer une intégration de données. Vous devez fournir un type d’objet Customer Profiles et un domaine Customer Profiles.

Si vous souhaitez exporter plusieurs types d’objets, vous devez créer une intégration de données distincte pour chacun d’entre eux. Par exemple, si vous souhaitez exporter les objets _profile et _asset, il est nécessaire de créer deux intégrations de données distinctes.

L'exemple de code suivant montre comment exécuter la commande 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"]}}'

L'exemple de code suivant montre comment appeler 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"
            ]
        }
    }
} 

Création d’une association d’intégration de données

Une association d’intégration de données représente la destination vers laquelle vous souhaitez exporter vos données et une plage de temps permettant de sélectionner les données à exporter. Vous pouvez appeler l'CreateDataIntegrationAssociationAPI ou exécuter la commande create-data-integration-associationCLI pour créer une intégration de données. Vous pouvez configurer l’intervalle de temps à l’aide des propriétés StartTime et EndTime. Cette plage horaire correspond à la date de dernière mise à jour des objets dans Profils des clients.

Le compartiment S3 de destination que vous spécifiez peut être simplement le nom du compartiment, ou il peut inclure un cas supplémentaire ou un préfixe S3 dans lequel vous souhaitez que les données soient exportées.

L'exemple de code suivant montre comment exécuter la commande 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"}}'

L'exemple de code suivant montre comment appeler 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"
        }
    }
}

Étape 3 : vérifier le statut d’une tâche d’exportation en bloc

Pour consulter l'état de votre tâche d'exportation en bloc, vous pouvez appeler l'ListDataIntegrationAssociationsAPI ou exécuter la commande list-data-integration-associationsCLI.

L'exemple de code suivant montre comment exécuter la commande list-data-integration-associationsCLI.

aws appintegrations list-data-integration-associations \
--region "us-west-2" \
--data-integration-identifier "unique-data-integration-name-01"

Étape 4 : afficher les données exportées dans S3

Lorsque l’association d’intégration des données est sur IN_PROGRESS, vous commencerez à voir les données copiées dans votre compartiment S3.

Les données exportées sont écrites selon la structure de chemin suivante :

Voici un exemple de chemin :

amzn-s3-demo-bucket1/123456789012/my-domain-pdx/20240607T175023/20240101T235959-20240430T235959/_profile/123456789012-1234-1234-123456789012

Mise à jour de la tâche d’exportation en bloc

Une fois le travail terminé, vous pouvez mettre à jour l’association d’intégration des données avec une heure de début et une heure de fin d’extraction des données différentes. Cela crée une nouvelle tâche d’exportation en masse. Cela peut être utile si vous avez déjà effectué une exportation en bloc et que vous souhaitez exporter uniquement les données mises à jour depuis l’exportation précédente. Par exemple, si votre dernière tâche d’exportation en masse remonte à trois mois, vous pouvez mettre à jour votre association d’intégration de données sur une période allant d’il y a 3 mois à aujourd’hui.

Vous pouvez appeler l'UpdateDataIntegrationAssociationAPI ou exécuter la commande update-data-integration-associationCLI pour mettre à jour la tâche d'exportation.

L'exemple de code suivant montre comment exécuter la commande 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"}}' 

Suppression ou annulation de la tâche d’exportation en bloc - non prise en charge

Vous ne pouvez pas supprimer ou annuler l’exportation groupée. Une fois qu’une tâche d’exportation est terminée, elle n’est plus prise en compte dans votre quota d’exportation.