Événements SMS

Si le canal SMS est activé pour un projet, Amazon Pinpoint peut diffuser des données d'événement sur les remises de messages SMS pour le projet. Les événements SMS générés par les opérateurs peuvent prendre jusqu'à 72 heures pour être reçus et ne doivent pas être utilisés pour déterminer s'il y a un retard dans la distribution des messages sortants. Après 72 heures, si Amazon Pinpoint n'a pas reçu d'événement final de la part d'un opérateur, le service renvoie automatiquement un record_status UNKNOWN car nous ne savons pas ce qu'il est advenu de ce message. 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.

Exemple

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

{
  "event_type": "_SMS.SUCCESS",
  "event_timestamp": 1553104954322,
  "arrival_timestamp": 1553104954064,
  "event_version": "3.1",
  "application": {
    "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "sdk": {}
  },
  "client": {
    "client_id": "123456789012"
  },
  "device": {
    "platform": {}
  },
  "session": {},
  "attributes": {
    "sender_request_id": "565d4425-4b3a-11e9-b0a5-example",
    "campaign_activity_id": "cbcfc3c5e3bd48a8ae2b9cb41example",
    "origination_phone_number": "[phone]",
    "destination_phone_number": "[phone]",
    "record_status": "DELIVERED",
    "iso_country_code": "US",
    "treatment_id": "0",
    "number_of_message_parts": "1",
    "message_id": "1111-2222-3333",
    "message_type": "Transactional",
    "campaign_id": "52dc44b35c4742c98c5935269example"
  },
  "metrics": {
    "price_in_millicents_usd": 645.0
  },
  "awsAccountId": "123456789012"
}

Attributs d'événement SMS

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 lorsque vous envoyez un SMS.

Événement
Attribut	Description
event_type	Type d'événement. Les valeurs possibles sont : _SMS.BUFFERED : le message est toujours en cours de remise au destinataire. _SMS.SUCCESS : le message a été accepté par l'opérateur/remis au destinataire. _SMS.FAILURE : Amazon Pinpoint n'a pas été en mesure de transmettre le message au destinataire. Pour en savoir plus sur l'erreur qui a empêché la remise du message, consultez attributes.record_status. _SMS.OPTOUT : le client a reçu le message et a répondu en envoyant le mot clé de refus (généralement « STOP »).
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 client d'application installé sur le périphérique 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 SMS, cet objet est vide.
session	Pour les événements SMS, cet objet est vide.
attributes	Attributs associés à l'événement. 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 une campagne, cet objet contient les attributs associés à la campagne. 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. Pour plus d'informations, consultez le tableau Attributs.
metrics	Métriques supplémentaires associées à l'événement. Pour plus d'informations, consultez le tableau Métriques.
awsAccountId	ID du AWS compte utilisé pour envoyer le message.

Application

Comporte des informations sur le projet Amazon Pinpoint auquel l'événement est associé et, le cas échéant, sur le kit SDK utilisé pour signaler l'événement.

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. Si vous envoyez un SMS transactionnel en appelant directement l'API Amazon Pinpoint ou en utilisant la console Amazon Pinpoint, cet objet est vide.

Attributs

Comporte des informations sur les attributs associés à l'événement.

Attribut	Description
sender_request_id	ID unique associé à la demande d'envoi du SMS.
campaign_activity_id	ID unique de l'activité au sein de la campagne.
origination_phone_number	Numéro de téléphone à partir duquel le message a été envoyé.
destination_phone_number	Numéro de téléphone auquel vous avez tenté d'envoyer le message.
record_status	Informations supplémentaires sur l'état du message. Les valeurs possibles incluent : SUCCESSFUL/DELIVERED : le message a été correctement remis. PENDING : le message n'a pas encore été remis à l'appareil du destinataire. INVALID : le numéro de téléphone de destination n'est pas valide. UNREACHABLE : l'appareil du destinataire est actuellement inaccessible ou indisponible. Par exemple, l'appareil peut être éteint ou déconnecté du réseau. Vous pouvez réessayer d'envoyer le message ultérieurement. UNKNOWN : une erreur s'est produite qui a empêché la remise du message. Cette erreur est généralement transitoire et vous pouvez essayer d'envoyer le message à nouveau ultérieurement. BLOCKED : l'appareil du destinataire bloque les SMS provenant du numéro d'origine. CARRIER_UNREACHABLE : un problème lié au réseau mobile du destinataire a empêché la remise du message. Cette erreur est généralement transitoire et vous pouvez essayer d'envoyer le message à nouveau ultérieurement. SPAM : l'opérateur mobile du destinataire a identifié le contenu du message comme courrier indésirable et a bloqué la distribution du message. INVALID_MESSAGE : le corps du message SMS n'est pas valide et ne peut pas être remis. CARRIER_BLOCKED : l'opérateur du destinataire a bloqué la distribution de ce message. Cela se produit souvent lorsque le transporteur identifie le contenu du message comme indésirable ou malveillant. TTL_EXPIRED : le SMS n'a pas pu être distribué dans un délai donné. Cette erreur est généralement transitoire et vous pouvez essayer d'envoyer le message à nouveau ultérieurement. MAX_PRICE_EXCEEDED : l'envoi du message aurait entraîné des frais supérieurs au quota de dépenses mensuelles pour l'envoi de SMS pour votre compte. Vous pouvez demander une augmentation de ce quota en suivant la procédure décrite dans la section Demander une augmentation de votre quota mensuel de dépenses en SMS du Guide de l'utilisateur Amazon Pinpoint. OPTED_OUT : le SMS n'a pas été envoyé car le destinataire a choisi de ne pas recevoir de messages de votre part. NO_QUOTA_LEFT_ON_ACCOUNT : le quota de dépenses restant sur votre compte est insuffisant pour envoyer le message. Vous pouvez demander une augmentation de ce quota en suivant la procédure décrite dans la section Demande d'augmentation de votre quota mensuel de dépenses par SMS dans le guide de l'utilisateur Amazon Pinpoint SMS. NO_ORIGINATION_IDENTITY_AVAILABLE_TO_SEND : votre compte ne contient aucun numéro de téléphone pouvant être utilisé pour envoyer le message à destination. DESTINATION_COUNTRY_NOT_SUPPORTED : le pays de destination est bloqué. Pour connaître tous les pays pris en charge, consultez la section Pays et régions pris en charge (canal SMS) dans le guide de l'utilisateur Amazon Pinpoint SMS. ACCOUNT_IN_SANDBOX : votre compte est dans l'environnement de test (sandbox) et il peut uniquement envoyer des messages vers des numéros de destination vérifiés. Vous pouvez vérifier le numéro de destination dans la console Amazon Pinpoint ou lancer le processus de transfert du compte hors du sandbox. Consultez la section Passer du sandbox Amazon Pinpoint SMS à la production dans le guide de l'utilisateur Amazon Pinpoint SMS. RATE_EXCEEDED : vous avez tenté d'envoyer un message trop rapidement et vous avez été limité. Vous devez ralentir votre débit d'appels. Pour en savoir plus sur nos limites, consultez les limites relatives au nombre de parties de messages par seconde (MPS) dans le guide de l'utilisateur Amazon Pinpoint SMS. INVALID_ORIGINATION_IDENTITY : l'identité d'origine fournie n'est pas valide. ORIGINATION_IDENTITY_DOES_NOT_EXIST : l'identité d'origine fournie n'existe pas. INVALID_DLT_PARAMETERS : des paramètres DLT non valides (obligatoires pour les destinations en Inde) ont été fournis. INVALID_PARAMETERS : des paramètres non valides ont été fournis. ACCESS_DENIED : l'envoi de messages est bloqué sur votre compte. Contactez le service client pour en déterminer la cause et résoudre le problème. INVALID_KEYWORD : le mot clé fourni n'est pas valide. Il se peut que le format du mot clé soit incorrect ou qu'il ne soit pas défini dans votre compte. INVALID_SENDER_ID : l'ID d'expéditeur fourni n'est pas valide. Le format ou la longueur de l'ID de l'expéditeur sont peut-être incorrects. INVALID_POOL_ID : l'ID de pool fourni n'est pas valide. Il se peut que le format de l'ID du pool soit incorrect ou qu'il n'appartienne pas à votre compte. SENDER_ID_NOT_SUPPORTED_FOR_DESTINATION : le pays de destination ne prend pas en charge l'ID de l'expéditeur. Vous devez utiliser un numéro de téléphone ou une autre identité d'origine pour l'envoi. INVALID_PHONE_NUMBER : le numéro de téléphone d'origine fourni n'est pas valide. Le format ou la longueur du numéro de téléphone peuvent être incorrects.
iso_country_code	Pays associé au numéro de téléphone du destinataire, affiché au format ISO 3166-1 alpha-2.
treatment_id	ID du traitement du message, si le message a été envoyé dans une campagne A/B.
treatment_id	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 SMS transactionnels, cette valeur est 0.
number_of_message_parts	Nombre de parties de message créées par Amazon Pinpoint pour envoyer le message. En général, les SMS ne peuvent contenir que 160 caractères GSM-7 ou 67 caractères autres que GSM, même si ces limites peuvent varier selon le pays . Si vous envoyez un message qui dépasse ces limites, Amazon Pinpoint fractionne automatiquement les messages en plusieurs parties. Nous vous facturons en fonction du nombre de parties du message que vous envoyez.
message_id	ID unique généré par Amazon Pinpoint lorsqu'il accepte le message.
message_type	Type du message. Les valeurs possibles sont Promotional et Transactional. Vous spécifiez cette valeur lorsque vous créez une campagne ou lorsque vous envoyez des messages transactionnels à l'aide de l'SendMessagesopération de l'API Amazon Pinpoint.
campaign_id	ID unique de la campagne Amazon Pinpoint qui a envoyé le message.

Client

Présente des informations sur le client d'application installé sur l'appareil qui a signalé l'événement.

Attribut	Description
client_id	Pour les événements générés par les applications, cette valeur est l'ID unique du client d'application installé sur l'appareil. Cet identifiant est automatiquement généré par le AWS Mobile SDK for iOS et le AWS Mobile SDK for Android. Pour les événements qui sont générés lorsque vous envoyez des campagnes et des messages transactionnels, cette valeur est égale à l'ID du point de terminaison auquel vous avez envoyé le message.
cognito_id	ID unique attribué au client d'application dans la réserve d'identités Amazon Cognito utilisée par votre application.

Appareil

Présente des informations sur l'appareil qui a signalé l'événement.

Attribut	Description
locale	Paramètres régionaux du périphérique.
make	Fabricant du périphérique, tel qu'Apple ou Samsung.
model	Modèle du périphérique, tel qu'iPhone.
platform	Plateforme du périphérique, telle qu'ios ou android.

Métriques

Comprend des informations sur les métriques associées à l'événement.

Attribut	Description
price_in_millicents_usd	Montant facturé pour l'envoi du message. Ce prix est indiqué en millièmes d'un cent des États-Unis. Par exemple, si la valeur de cet attribut est 645, nous vous avons facturé 0,645 ¢ pour envoyer le message (645 / 1000 = 0,645 ¢ = 0,00645 $). Note Cette propriété n'apparaît pas pour les messages ayant un event_type _SMS.BUFFERED.