**Avis de fin de support :** le 30 octobre 2026, le support d'Amazon Pinpoint AWS prendra fin. Après le 30 octobre 2026, vous ne pourrez plus accéder à la console Amazon Pinpoint ni aux ressources Amazon Pinpoint (points de terminaison, segments, campagnes, parcours et analytique). Pour plus d’informations, consultez [Fin de la prise en charge d’Amazon Pinpoint](https://docs.aws.amazon.com/console/pinpoint/migration-guide). **Remarque :** en ce qui APIs concerne les SMS, la voix, le push mobile, l'OTP et la validation des numéros de téléphone ne sont pas concernés par cette modification et sont pris en charge par AWS la messagerie utilisateur final.

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.

# Flux de données d'événements par e-mail provenant d'Amazon Pinpoint
<a name="event-streams-data-email"></a>

Si vous utilisez Amazon Pinpoint pour envoyer des e-mails, Amazon Pinpoint peut diffuser des données d'événements concernant ces e-mails. Une fois que vous avez configuré le streaming d'événements, Amazon Pinpoint extrait les données de vos événements depuis la destination que vous avez spécifiée lors de la configuration pour que vous puissiez les consulter. Pour plus d'informations sur la configuration de la diffusion d'événements, consultez[Configurer Amazon Pinpoint pour diffuser les données d'événements des applications via Amazon Kinesis ou Amazon Data Firehose](event-streams-setup.md). Amazon Pinpoint diffuse des données relatives aux types d'événements suivants pour les e-mails :
+ Envois
+ Messages délivrés
+ Retours à l'expéditeur
+ Réclamations
+ Messages ouverts
+ Clics
+ Rejets
+ Désabonnement
+ Échec du rendu

Ces types d'événements sont expliqués en détail dans[Attributs d'événement d'e-mail](#event-streams-data-email-attributes).

Selon l'API et les paramètres que vous utilisez pour envoyer des messages électroniques, vous pouvez voir des types d'événements supplémentaires ou des données différentes. Par exemple, si vous envoyez des messages à l'aide de jeux de configuration qui publient des données d'événement dans Amazon Kinesis, tels que ceux fournis par Amazon Simple Email Service (Amazon SES), les données peuvent également inclure des événements pour des échecs de rendu de modèle. Pour plus d'informations sur ces données, consultez [Surveillance à l'aide de la publication d'événements Amazon SES](https://docs.aws.amazon.com/ses/latest/dg/monitor-using-event-publishing.html) dans le *Guide du développeur Amazon Simple Email Service*. Avant de pouvoir visionner vos événements, vous devez configurer le streaming des événements, voir[Configurer Amazon Pinpoint pour diffuser les données d'événements des applications via Amazon Kinesis ou Amazon Data Firehose](event-streams-setup.md). Lorsque vous configurez le streaming d'événements, vous spécifiez une destination pour l'enregistrement des données de votre événement, puis vous pouvez utiliser cette destination pour récupérer les données de vos événements afin de les consulter.

## Exemples d'événements par e-mail
<a name="event-streams-data-email-example"></a>

**Envoi d'e-mails**  
L'objet JSON d'un événement *email send* contient les données illustrées dans l'exemple suivant.

```
{
  "event_type": "_email.send",
  "event_timestamp": 1564618621380,
  "arrival_timestamp": 1564618622025,
  "event_version": "3.1",
  "application": {
    "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "sdk": {}
  },
  "client": {
    "client_id": "9a311b17-6f8e-4093-be61-4d0bbexample"
  },
  "device": {
    "platform": {}
  },
  "session": {},
  "attributes": {
    "feedback": "received"
  },
  "awsAccountId": "123456789012",
  "facets": {
    "email_channel": {
      "mail_event": {
        "mail": {
          "message_id": "0200000073rnbmd1-mbvdg3uo-q8ia-m3ku-ibd3-ms77kexample-000000",
          "message_send_timestamp": 1564618621380,
          "from_address": "sender@example.com",
          "destination": ["recipient@example.com"],
          "headers_truncated": false,
          "headers": [{
            "name": "From",
            "value": "sender@example.com"
          }, {
            "name": "To",
            "value": "recipient@example.com"
          }, {
            "name": "Subject",
            "value": "Amazon Pinpoint Test"
          }, {
            "name": "MIME-Version",
            "value": "1.0"
          }, {
            "name": "Content-Type",
            "value": "multipart/alternative;  boundary=\"----=_Part_314159_271828\""
          }],
          "common_headers": {
            "from": "sender@example.com",
            "to": ["recipient@example.com"],
            "subject": "Amazon Pinpoint Test"
          }
        },
        "send": {}
      }
    }
  }
}
```

**Livraison d'e-mail**  
L'objet JSON d'un événement *email delivered* contient les données illustrées dans l'exemple suivant.

```
{
  "event_type": "_email.delivered",
  "event_timestamp": 1564618621380,
  "arrival_timestamp": 1564618622690,
  "event_version": "3.1",
  "application": {
    "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "sdk": {}
  },
  "client": {
    "client_id": "e9a3000d-daa2-40dc-ac47-1cd34example"
  },
  "device": {
    "platform": {}
  },
  "session": {},
  "attributes": {
    "feedback": "delivered"
  },
  "awsAccountId": "123456789012",
  "facets": {
    "email_channel": {
      "mail_event": {
        "mail": {
          "message_id": "0200000073rnbmd1-mbvdg3uo-q8ia-m3ku-ibd3-ms77kexample-000000",
          "message_send_timestamp": 1564618621380,
          "from_address": "sender@example.com",
          "destination": ["recipient@example.com"],
          "headers_truncated": false,
          "headers": [{
            "name": "From",
            "value": "sender@example.com"
          }, {
            "name": "To",
            "value": "recipient@example.com"
          }, {
            "name": "Subject",
            "value": "Amazon Pinpoint Test"
          }, {
            "name": "MIME-Version",
            "value": "1.0"
          }, {
            "name": "Content-Type",
            "value": "multipart/alternative;  boundary=\"----=_Part_314159_271828\""
          }],
          "common_headers": {
            "from": "sender@example.com",
            "to": ["recipient@example.com"],
            "subject": "Amazon Pinpoint Test"
          }
        },
        "delivery": {
          "smtp_response": "250 ok:  Message 82080542 accepted",
          "reporting_mta": "a8-53.smtp-out.amazonses.com",
          "recipients": ["recipient@example.com"],
          "processing_time_millis": 1310
        }
      }
    }
  }
}
```

**Clic sur e-mail**  
L'objet JSON d'un événement *email click* contient les données illustrées dans l'exemple suivant.

```
{
  "event_type": "_email.click",
  "event_timestamp": 1564618621380,
  "arrival_timestamp": 1564618713751,
  "event_version": "3.1",
  "application": {
    "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "sdk": {}
  },
  "client": {
    "client_id": "49c1413e-a69c-46dc-b1c4-6470eexample"
  },
  "device": {
    "platform": {}
  },
  "session": {},
  "attributes": {
    "feedback": "https://aws.amazon.com/pinpoint/"
  },
  "awsAccountId": "123456789012",
  "facets": {
    "email_channel": {
      "mail_event": {
        "mail": {
          "message_id": "0200000073rnbmd1-mbvdg3uo-q8ia-m3ku-ibd3-ms77kexample-000000",
          "message_send_timestamp": 1564618621380,
          "from_address": "sender@example.com",
          "destination": ["recipient@example.com"],
          "headers_truncated": false,
          "headers": [{
            "name": "From",
            "value": "sender@example.com"
          }, {
            "name": "To",
            "value": "recipient@example.com"
          }, {
            "name": "Subject",
            "value": "Amazon Pinpoint Test"
          }, {
            "name": "MIME-Version",
            "value": "1.0"
          }, {
            "name": "Content-Type",
            "value": "multipart/alternative;  boundary=\"----=_Part_314159_271828\""
          }, {
            "name": "Message-ID",
            "value": "null"
          }],
          "common_headers": {
            "from": "sender@example.com",
            "to": ["recipient@example.com"],
            "subject": "Amazon Pinpoint Test"
          }
        },
        "click": {
          "ip_address": "72.21.198.67",
          "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/12.1.2 Safari/605.1.15",
          "link": "https://aws.amazon.com/pinpoint/"
        }
      }
    }
  }
}
```

**Ouvertures d'e-mails**  
L'objet JSON d'un événement *email open* contient les données illustrées dans l'exemple suivant.

```
{
  "event_type": "_email.open",
  "event_timestamp": 1564618621380,
  "arrival_timestamp": 1564618712316,
  "event_version": "3.1",
  "application": {
    "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "sdk": {}
  },
  "client": {
    "client_id": "8dc1f651-b3ec-46fc-9b67-2a050example"
  },
  "device": {
    "platform": {}
  },
  "session": {},
  "attributes": {
    "feedback": "opened"
  },
  "awsAccountId": "123456789012",
  "facets": {
    "email_channel": {
      "mail_event": {
        "mail": {
          "message_id": "0200000073rnbmd1-mbvdg3uo-q8ia-m3ku-ibd3-ms77kexample-000000",
          "message_send_timestamp": 1564618621380,
          "from_address": "sender@example.com",
          "destination": ["recipient@example.com"],
          "headers_truncated": false,
          "headers": [{
            "name": "From",
            "value": "sender@example.com"
          }, {
            "name": "To",
            "value": "recipient@example.com"
          }, {
            "name": "Subject",
            "value": "Amazon Pinpoint Test"
          }, {
            "name": "MIME-Version",
            "value": "1.0"
          }, {
            "name": "Content-Type",
            "value": "multipart/alternative;  boundary=\"----=_Part_314159_271828\""
          }, {
            "name": "Message-ID",
            "value": "null"
          }],
          "common_headers": {
            "from": "sender@example.com",
            "to": ["recipient@example.com"],
            "subject": "Amazon Pinpoint Test"
          }
        },
        "open": {
          "ip_address": "72.21.198.67",
          "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_6) AppleWebKit/605.1.15 (KHTML, like Gecko)"
        }
      }
    }
  }
}
```

## Attributs d'événement d'e-mail
<a name="event-streams-data-email-attributes"></a>

Cette section définit les attributs inclus dans l'exemple précédent des données de flux d'événements générées par Amazon Pinpoint lorsque vous envoyez des e-mails.


| Attribut | Description | 
| --- | --- | 
| event\$1type |  Type d'événement. Les valeurs possibles sont : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/pinpoint/latest/developerguide/event-streams-data-email.html)  | 
| event\$1timestamp |  Heure à laquelle le message a été envoyé, indiquée exprimée en millisecondes de temps Unix. Cette valeur est généralement la même pour tous les événements générés pour un message.  | 
| arrival\$1timestamp |  Heure à laquelle l'événement a été reçu par Amazon Pinpoint, affichée sous la forme Heure Unix en millisecondes.  | 
| event\$1version |  Version du schéma JSON de l'événement.  Vérifiez la version dans votre application de traitement des événements afin de savoir à quel moment mettre à jour l'application suite à une mise à jour du schéma.   | 
| application |  Informations sur le projet Amazon Pinpoint associé à l'événement. Pour plus d'informations, consultez le tableau *Application*.  | 
| client |  Informations sur le client d'application installé sur l'appareil qui a signalé l'événement. Pour plus d'informations, consultez le tableau *Client*.  | 
| device |  Informations sur l'appareil qui a signalé l'événement. Pour plus d'informations, consultez le tableau *Appareil*. Pour les événements d'e-mail, cet objet est vide.  | 
| session | Pour les événements d'e-mail, cet objet est vide. | 
| attributes |  Attributs associés à l'événement. Pour plus d'informations, consultez le tableau *Attributs*. Pour les événements rapportés par l'une de vos applications, cet objet peut inclure des attributs personnalisés qui sont définis par l'application. Pour les événements qui sont créés lorsque vous envoyez un message à partir d'une campagne ou d'un parcours, cet objet contient les attributs associés à la campagne ou au parcours. Pour les événements qui sont générés lorsque vous envoyez des messages transactionnels, cet objet contient des informations liées au message lui-même.  | 
| client\$1context | Pour les événements de messagerie, cet objet contient un objet custom, qui contient un attribut legacy\$1identifier. La valeur de l'attribut legacy\$1identifier est l'ID du projet à partir de laquelle le message a été envoyé. | 
| facets |  Informations supplémentaires sur le message, telles que les en-têtes d'e-mail. Consultez le tableau *Facettes* pour plus d'informations.  | 
| awsAccountId |  L'ID du AWS compte qui a été utilisé pour envoyer le message.  | 

### Application
<a name="event-streams-data-email-attributes-application"></a>

Inclut les informations sur le projet Amazon Pinpoint auquel l'événement est associé.


| Attribut | Description | 
| --- | --- | 
| app\$1id |  ID unique du projet Amazon Pinpoint qui a signalé l'événement.  | 
| sdk |  Le kit SDK qui a été utilisé pour signaler l'événement. Si vous envoyez un e-mail transactionnel en appelant directement l'API Amazon Pinpoint ou en utilisant la console Amazon Pinpoint, cet objet est vide.  | 

### Attributs
<a name="event-streams-data-email-attributes-attrs"></a>

Inclut des informations sur la campagne ou le parcours qui a généré l'événement.

#### Campagne
<a name="event-streams-data-email-attributes-attrs-campaigns"></a>

Inclut des informations sur la campagne qui a généré l'événement.


| Attribut | Description | 
| --- | --- | 
| feedback |  Pour les événements `_email.click`, la valeur de cet attribut est l'URL du lien sur lequel le destinataire a cliqué dans le message pour générer l'événement. Pour les autres événements, cette valeur représente le type d'événement, tel que `received`, `opened` ou `clicked`.  | 
| treatment\$1id |  Si le message a été envoyé à l'aide d'une campagne de test A/B, cette valeur représente le numéro de traitement du message. Pour les campagnes standard et les e-mails transactionnels, cette valeur est `0`.  | 
| campaign\$1activity\$1id | ID unique généré par Amazon Pinpoint lorsque l'événement se produit. | 
| campaign\$1id |  ID unique de la campagne qui a envoyé le message.  | 

#### Parcours
<a name="event-streams-data-email-attributes-attrs-journey"></a>

Inclut des informations sur le parcours qui a généré l'événement.


| Attribut | Description | 
| --- | --- | 
| journey\$1run\$1id | ID unique de l'exécution du parcours qui a envoyé le message. Amazon Pinpoint génère et attribue automatiquement cet identifiant à chaque nouvelle étape d'un parcours. | 
| feedback |  Pour les événements `_email.click`, la valeur de cet attribut est l'URL du lien sur lequel le destinataire a cliqué dans le message pour générer l'événement. Pour les autres événements, cette valeur représente le type d'événement, tel que `received`, `delivered` ou `opened`.  | 
| journey\$1id | ID unique du parcours qui a envoyé le message. | 
| journey\$1activity\$1id | ID unique de l'activité de parcours qui a envoyé le message. | 

### Client
<a name="event-streams-data-email-attributes-client"></a>

L'identifiant unique du client ciblé par la campagne ou le parcours.


| Attribut | Description | 
| --- | --- | 
| client\$1id | ID du client. La valeur est l'identifiant du point de terminaison pour les campagnes et les parcours, et pour l'envoi transactionnel, il s'agit d'un UUID. | 

### Facettes
<a name="event-streams-data-email-attributes-facets"></a>

Inclut des informations sur le message et le type d'événement.


| Attribut | Description | 
| --- | --- | 
| email\$1channel |  Contient un objet `mail_event`, qui contient deux objets : `mail` et un objet correspondant au type d'événement.  | 

### Mail
<a name="event-streams-data-email-attributes-mail"></a>

Inclut des informations sur le contenu de l'e-mail, ainsi que des métadonnées liées au message.


| Attribut | Description | 
| --- | --- | 
| message\$1id |  ID unique du message. Amazon Pinpoint génère automatiquement cet ID lorsqu'il accepte le message.  | 
| message\$1send\$1timestamp |  Date et heure auxquelles le message a été envoyé au format spécifié dans [RFC 822](https://datatracker.ietf.org/doc/html/rfc822).  | 
| from\$1address |  Adresse e-mail à partir de laquelle le message a été envoyé.  | 
| destination |  Tableau contenant les adresses e-mail auxquelles le message a été envoyé.  | 
| headers\$1truncated |  Valeur booléenne qui indique si les en-têtes d'e-mail ont été tronqués.  | 
| headers |  Objet qui contient plusieurs paires nom-valeur correspondant aux en-têtes du message. Cet objet contient généralement des informations sur les en-têtes suivants : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/pinpoint/latest/developerguide/event-streams-data-email.html)  | 
| common\$1headers |  Contient des informations sur plusieurs en-têtes communs pour les messages électroniques. Les informations peuvent inclure la date à laquelle le message a été envoyé, ainsi que les lignes de destination, d'expéditeur et d'objet du message.  |