Événements de campagne - Amazon Pinpoint
Exemple d'événementAttributs d'événement de campagne

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.

Événements de campagne

Si vous utilisez Amazon Pinpoint pour envoyer des campagnes via un canal, Amazon Pinpoint peut diffuser des données d'événements sur ces campagnes. Cela inclut des données d'événement pour tous les messages électroniques ou SMS que vous envoyez à partir d'une campagne. Pour plus d'informations sur les données diffusées par Amazon Pinpoint pour ces types de messages, consultez Événements d'e-mail et SMSévénements. 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 d'événement

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

{
  "event_type": "_campaign.send",
  "event_timestamp": 1562109497426,
  "arrival_timestamp": 1562109497494,
  "event_version": "3.1",
  "application": {
    "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "sdk": {}
  },
  "client": {
    "client_id": "d8dcf7c5-e81a-48ae-8313-f540cexample"
  },
  "device": {
    "platform": {}
  },
  "session": {},
  "attributes": {
    "treatment_id": "0",
    "campaign_activity_id": "5473285727f04865bc673e527example",
    "delivery_type": "GCM",
    "campaign_id": "4f8d6097c2e8400fa3081d875example",
    "campaign_send_status": "SUCCESS"
  },
  "client_context": {
    "custom": {
      "endpoint": "{\"ChannelType\":\"GCM\",\"EndpointStatus\":\"ACTIVE\",
          ↳\"OptOut\":\"NONE\",\"RequestId\":\"ec229696-9d1e-11e9-8bf1-85d0aexample\",
          ↳\"EffectiveDate\":\"2019-07-02T23:12:54.836Z\",\"User\":{}}"
    }
  },
  "awsAccountId": "123456789012"
}

Attributs d'événement de campagne

Cette section définit les attributs qui sont inclus dans le flux d'événements de la campagne.

Attribut Description
event_type

Type d'événement. Les valeurs possibles sont :

  • _campaign.send : Amazon Pinpoint a exécuté la campagne.

  • _campaign.opened_notification : pour les campagnes de notification push, ce type d'événement indique que le destinataire a utilisé la notification pour l'ouvrir.

  • _campaign.received_foreground : pour les campagnes de notification push, ce type d'événement indique que le destinataire a reçu le message en tant que notification au premier plan.

  • _campaign.received_background : pour les campagnes de notification push, ce type d'événement indique que le destinataire a reçu le message en tant que notification en arrière plan.

    Note

    _campaign.opened_notification, _campaign.received_foreground et _campaign.received_background sont uniquement renvoyés si vous utilisez AWS Amplify. Pour plus d'informations sur l'intégration de votre application à AWS Amplify. veuillez consulter Connexion de votre application frontale à Amazon Pinpoint avec AWS Amplify.
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 messages de campagne et transactionnels, cet objet est vide.
session

Informations sur la session qui a généré l'événement. Pour les campagnes, 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.
client_context Contient un objet custom, qui contient une propriété endpoint. La propriété endpoint propriété contient le contenu de l'enregistrement de point de terminaison pour le point de terminaison auquel la campagne a été envoyée.
awsAccountId

L'ID du AWS compte qui a été utilisé pour envoyer le message.

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.

Attributs

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

Attribut Description
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 campagnes standard, cette valeur est 0.
campaign_activity_id ID unique généré par Amazon Pinpoint lorsque l'événement se produit.
delivery_type

Mode de livraison de la campagne. Ne confondez pas cet attribut avec le champ ChannelType spécifié sous la propriété endpoint de client_context. Le champ ChannelType est généralement basé sur le point de terminaison auquel le message est envoyé.

Pour les canaux qui ne prennent en charge qu'un seul type de point de terminaison, les champs delivery_type et ChannelType ont la même valeur. Par exemple, pour le canal e-mail, les champs delivery_type et ChannelType ont la même valeur que EMAIL.

Toutefois, cette condition n'est pas toujours vraie pour les canaux qui prennent en charge différents types de points de terminaison, tels que les canaux personnalisés. Vous pouvez utiliser un canal personnalisé pour différents points de terminaison, tels que EMAIL, SMS, CUSTOM, etc. Dans ce cas, le delivery_type identifie un événement de distribution personnalisé, CUSTOM, et ChannelType spécifie le type de point de terminaison auquel la campagne a été envoyée, tel que EMAIL, SMS, CUSTOM, etc. Pour en savoir plus sur la création de canaux personnalisés, consultez la section Création de canaux personnalisées dans Amazon Pinpoint.

Les valeurs possibles sont :

  • EMAIL

  • SMS

  • ADM

  • APNS

  • APNS_SANDBOX

  • APNS_VOIP

  • APNS_VOIP_SANDBOX

  • VOICE

  • GCM

  • BAIDU

  • PUSH

  • CUSTOM
campaign_id

ID unique de la campagne à partir de laquelle le message a été envoyé.
campaign_send_status Indique le statut de la campagne pour le point de terminaison cible. Les valeurs possibles incluent :

  • SUCCESS : la campagne a été envoyée avec succès au point de terminaison.

  • FAILURE : la campagne n'a pas été envoyée au point de terminaison.

  • DAILY_CAP : la campagne n'a pas été envoyée au point de terminaison, car le nombre maximal de messages quotidiens a déjà été envoyé au point de terminaison.

  • EXPIRED : la campagne n'a pas été envoyée au point de terminaison, car son envoi dépasserait la durée maximale ou les paramètres de taux d'envoi de la campagne.

  • QUIET_TIME : la campagne n'a pas été envoyée au point de terminaison en raison de restrictions de temps de pause.

  • HOLDOUT : la campagne n'a pas été envoyée au point de terminaison, car ce dernier était membre du groupe d'éléments d'arrêt.

  • DUPLICATE_ADDRESS : le segment contient des adresses de point de terminaison dupliquées. La campagne a été envoyée une fois à l'adresse du point de terminaison.

  • QUIET_TIME : la campagne n'a pas été envoyée au point de terminaison en raison de restrictions de temps de pause.

  • CAMPAIGN_CAP : la campagne n'a pas été envoyée au point de terminaison, car le nombre maximal de messages a déjà été envoyé au point de terminaison à partir de cette campagne.

  • FAILURE_PERMANENT : une défaillance permanente s'est produite lors de l'envoi vers le point de terminaison.

  • TRANSIENT_FAILURE : une défaillance transitoire s'est produite lors de l'envoi vers le point de terminaison.

  • THROTTLED : l'envoi a été limité.

  • UNKNOWN : défaillance inconnue.

  • HOOK_FAILURE : le hook de campagne a échoué.

  • CUSTOM_DELIVERY_FAILURE : la distribution personnalisée a échoué.

  • RECOMMENDATION_FAILURE : le moteur de recommendation a échoué.

  • UNSUPPORTED_CHANNEL : le canal n'est pas pris en charge.

Client

Inclut des informations sur le point de terminaison qui a été ciblé par la campagne.

Attribut Description
client_id ID du point de terminaison auquel la campagne a été envoyée.