Événements de parcours

Si vous publiez un parcours, Amazon Pinpoint peut diffuser des données d'événement sur le parcours. Cela inclut des données d'événement pour tous les e-mails, SMS, notifications push ou messages personnalisés que vous envoyez à partir du parcours. Avant de pouvoir visionner vos événements, vous devez configurer le streaming des événements, voirConfiguration de la diffusion en continu des événements. 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.

Consultez les informations suivantes pour obtenir des informations sur les données diffusées par Amazon Pinpoint :

• Pour les e-mails, consultez Événements d'e-mail.

• Pour les SMS, consultez Événements SMS.

Exemple d'événement

L'objet JSON d'un événement de parcours contient les données illustrées dans l'exemple suivant.

{
   "event_type":"_journey.send",
   "event_timestamp":1572989078843,
   "arrival_timestamp":1572989078843,
   "event_version":"3.1",
   "application":{
      "app_id":"a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
      "sdk":{

      }
   },
   "client":{
      "client_id":"d8dcf7c5-e81a-48ae-8313-f540cexample"
   },
   "device":{
      "platform":{

      }
   },
   "session":{

   },
   "attributes":{
      "journey_run_id":"edc9a0b577164d1daf72ebd15example",
      "journey_send_status":"SUCCESS",
      "journey_id":"546401670c5547b08811ac6a9example",
      "journey_activity_id":"0yKexample",
      "journey_activity_type": "EMAIL",
      "journey_send_status_message": "200", 
      "journey_send_status_code": "200"
   },
   "client_context":{
      "custom":{
         "endpoint":"{\"ChannelType\":\"EMAIL\",\"EndpointStatus\":\"ACTIVE\",\"OptOut\":\"NONE\",\"Demographic\":{\"Timezone\":\"America/Los_Angeles\"}}"
      }
   },
   "awsAccountId":"123456789012"
}

Attributs de l'événement de parcours

Cette section définit les attributs qui sont inclus dans les données de flux d'événements générés par Amazon Pinpoint pour un parcours.

Attribut	Description
event_type	Type d'événement. Pour les événements de parcours, la valeur de cet attribut est toujours _journey.send, ce qui indique que le parcours a été exécuté par Amazon Pinpoint.
event_timestamp	Heure à laquelle l'événement a été signalé, affichée sous la forme Heure Unix en millisecondes.
arrival_timestamp	Heure à laquelle l'événement a été reçu par Amazon Pinpoint, affichée sous la forme Heure Unix en millisecondes.
event_version	Version du schéma JSON de l'événement. Astuce 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 point de terminaison auquel l'événement est associé. Pour plus d'informations, consultez le tableau Client.
device	Informations sur l'appareil qui a signalé l'événement. Pour les parcours, cet objet est vide.
session	Informations sur la session qui a généré l'événement. Pour les parcours, cet objet est vide.
attributes	Attributs associés au parcours et à l'activité de parcours et de parcours qui a généré l'événement. Pour plus d'informations, consultez le tableau Attributs.
client_context	Contient un objet custom, qui contient une propriété endpoint. La propriété endpoint contient les contenus de l'enregistrement de point de terminaison du point de terminaison associé à l'événement.
awsAccountId	L'identifiant du AWS compte utilisé pour exécuter le trajet.

Application

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

Attribut	Description
app_id	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.

Client

Inclut des informations sur le point de terminaison associé à l'événement.

Attribut	Description
client_id	ID du point de terminaison.

Attributs

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

Attribut	Description
journey_run_id	ID unique de l'exécution du parcours qui a généré l'événement. Amazon Pinpoint génère et attribue automatiquement cet identifiant à chaque nouvelle étape d'un parcours.
journey_send_status	Indique l'état de remise du message qui est associé à l'événement. Les valeurs possibles incluent : SUCCESS : le message a été envoyée avec succès au point de terminaison. FAILURE : le message n'a pas été envoyé au point de terminaison car une erreur s'est produite. CUSTOM_DELIVERY_FAILURE : la distribution personnalisée a échoué. FAILURE_PERMANENT : une défaillance permanente s'est produite lors de l'envoi vers le point de terminaison. Astuce Vous pouvez filtrer les événements dont le statut FAILURE_PERMANENT est journey_send_status_code défini sur 403 pour déterminer s'il existe une politique d'accès et une violation de rôle. Pour les campagnes sortantes avec voix, ces exceptions sont typiques des cas où le rôle d'exécution de campagnes Connect liant les campagnes Amazon Pinpoint Journeys à Amazon Connect est supprimé par inadvertance pour les exécutions de trajets en vol. THROTTLED : l'envoi a été limité. UNSUPPORTED_CHANNEL : le canal n'est pas pris en charge. DAILY_CAP : le message n'a pas été envoyé au point de terminaison car l'envoi du message dépasserait le nombre maximum de messages que le parcours ou le projet peut envoyer à un point de terminaison unique sur une période de 24 heures. QUIET_TIME : le message n'a pas été envoyé en raison des restrictions relatives au temps de pause pendant le parcours ou le projet. QUIET_TIME_MISSING_TIMEZONE : le message n'a pas été envoyé car l'estimation du fuseau horaire n'a pas pu estimer le fuseau horaire du point de terminaison et le temps de pause est activé.
journey_id	ID unique du parcours qui a généré l'événement.
journey_activity_id	ID unique de l'activité de parcours qui a généré l'événement.
journey_activity_type	Type d'activité lié au parcours de l'événement. Cela peut être EMAIL, SMS, PUSH, CONTACT_CENTER ou CUSTOM. Note VOICE n'est pas un type d'activité de parcours pris en charge.
journey_send_status_message	Description de l'état de l'événement d'envoi.
journey_send_status_code	Code d'état HTTP de la demande.