Flusso di dati sugli eventi della campagna da Amazon Pinpoint - Amazon Pinpoint
Esempio di evento della campagnaAttributi degli eventi di campagna

Avviso di fine del supporto: il 30 ottobre 2026, AWS terminerà il supporto per Amazon Pinpoint. Dopo il 30 ottobre 2026, non potrai più accedere alla console Amazon Pinpoint o alle risorse Amazon Pinpoint (endpoint, segmenti, campagne, percorsi e analisi). Per ulteriori informazioni, consulta la pagina relativa alla fine del supporto di Amazon Pinpoint. Nota: per quanto APIs riguarda gli SMS, i comandi vocali, i messaggi push su dispositivi mobili, l'OTP e la convalida del numero di telefono non sono interessati da questa modifica e sono supportati da AWS End User Messaging.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Flusso di dati sugli eventi della campagna da Amazon Pinpoint

Se utilizzi Amazon Pinpoint per inviare campagne tramite un canale, Amazon Pinpoint può trasmettere in streaming i dati sugli eventi relativi a tali campagne. Dopo aver configurato lo streaming degli eventi, Amazon Pinpoint recupera i dati degli eventi dell'app per e-mail o SMS che invii da una campagna dalla destinazione specificata durante la configurazione per consentirti di visualizzarli. Per informazioni dettagliate sui dati trasmessi da Amazon Pinpoint per e-mail e SMS, consulta e. Flusso di dati sugli eventi di posta elettronica da Amazon Pinpoint Flusso di dati di eventi SMS da Amazon Pinpoint Per informazioni su come configurare lo streaming di eventi, consulta. Configura Amazon Pinpoint per lo streaming dei dati degli eventi delle app tramite Amazon Kinesis o Amazon Data Firehose

Esempio di evento della campagna

L'oggetto JSON per un evento della campagna contiene i dati mostrati nell'esempio seguente.

{
  "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"
}

Attributi degli eventi di campagna

Questa sezione definisce gli attributi inclusi nel flusso di eventi della campagna.

Attributo Descrizione
event_type

Tipo di evento. I valori possibili sono:

  • _campaign.send: Amazon Pinpoint ha eseguito la campagna.

  • _campaign.opened_notification: per le campagne basate sulle notifiche push, questo tipo di evento indica che il destinatario ha toccato la notifica per aprirla.

  • _campaign.received_foreground: per le campagne basate sulle notifiche push, questo tipo di evento indica che il destinatario ha ricevuto il messaggio come notifica in primo piano.

  • _campaign.received_background: per le campagne basate sulle notifiche push, questo tipo di evento indica che il destinatario ha ricevuto il messaggio come notifica in background.

    Nota

    _campaign.opened_notification, _campaign.received_foreground e _campaign.received_background vengono restituiti solo se utilizzi AWS Amplify. Per ulteriori informazioni sull'integrazione della tua app con. AWS Amplify Per informazioni, consulta Connect l'applicazione frontend ad Amazon AWS Pinpoint utilizzando Amplify.
event_timestamp

L'ora in cui l'evento è stato segnalato, espressa nel formato orario Unix in millisecondi.
arrival_timestamp

L'ora in cui l'evento è stato ricevuto da Amazon Pinpoint, espressa nel formato orario Unix in millisecondi.
event_version

La versione dello schema JSON dell'evento.

Suggerimento

Seleziona questa versione nell'applicazione di elaborazione eventi in modo da sapere quando aggiornare l'applicazione in risposta a un aggiornamento dello schema.
application

Informazioni sul progetto Amazon Pinpoint associato all'evento. Per ulteriori informazioni, consulta la tabella Applicazione.
client

Informazioni sull'endpoint a cui è associato l'evento. Per ulteriori informazioni, consulta la tabella Client.
device

Informazioni sul dispositivo che ha segnalato l'evento. Per i messaggi di campagna e transazionali, questo oggetto è vuoto.
session

Informazioni sulla sessione che ha generato l'evento. Per le campagne, questo oggetto è vuoto.
attributes

Attributi associati all'evento. Per gli eventi segnalati da una delle app, questo oggetto può includere attributi personalizzati definiti dall'app. Per gli eventi che vengono creati quando si invia una campagna, questo oggetto contiene gli attributi associati alla campagna. Per gli eventi che vengono generati quando si inviano messaggi transazionali, questo oggetto contiene informazioni correlate al messaggio stesso.

Per ulteriori informazioni, consulta la tabella Attributi.
client_context Contiene un oggetto custom, che contiene una proprietà endpoint. La proprietà endpoint contiene i contenuti del record di endpoint per l'endpoint a cui è stata inviata la campagna.
awsAccountId

L'ID dell' AWS account utilizzato per inviare il messaggio.

Applicazione

Include informazioni sul progetto Amazon Pinpoint a cui è associato l'evento.

Attributo Descrizione
app_id

ID univoco del progetto Amazon Pinpoint che ha segnalato l'evento.
sdk

L'SDK utilizzato per segnalare l'evento.

Attributes

Include informazioni sulla campagna che ha prodotto l'evento.

Attributo Descrizione
treatment_id

Se il messaggio è stato inviato utilizzando una campagna di test A/B, questo valore rappresenta il numero della descrizione (treatment) del messaggio. Per le campagne standard, questo valore è 0.
campaign_activity_id ID univoco generato da Amazon Pinpoint quando si verifica l'evento.
delivery_type

Metodo di recapito della campagna. Non confondere questo attributo con il campo ChannelType specificato sotto la proprietà endpoint di client_context. Il campo ChannelType è in genere basato sull'endpoint a cui viene inviato il messaggio.

Per i canali che supportano un solo tipo di endpoint, i campi delivery_type e ChannelType hanno lo stesso valore. Ad esempio, per il canale e-mail, i campi delivery_type e ChannelType hanno lo stesso valore di EMAIL.

Tuttavia, questa condizione non è sempre vera per i canali che supportano diversi tipi di endpoint, come i canali personalizzati. Puoi utilizzare un canale personalizzato per diversi endpoint, come EMAIL, SMS, CUSTOM e così via. In questo caso, delivery_type identifica un evento di recapito personalizzato (CUSTOM) e ChannelType specifica il tipo di endpoint a cui è stata inviata la campagna, ad esempio EMAIL, SMS, CUSTOM e così via. Per ulteriori informazioni sulla creazione di canali personalizzati, consulta Crea un canale personalizzato in Amazon Pinpoint utilizzando un webhook o una funzione Lambda.

I valori possibili sono:

  • EMAIL

  • SMS

  • ADM

  • APNS

  • APNS_SANDBOX

  • APNS_VOIP

  • APNS_VOIP_SANDBOX

  • VOICE

  • GCM

  • BAIDU

  • PUSH

  • CUSTOM
campaign_id

L'ID univoco della campagna da cui è stato inviato il messaggio.
campaign_send_status Indica lo stato della campagna per l'endpoint di destinazione. I valori possibili includono:

  • SUCCESS: invio della campagna all'endpoint riuscito.

  • FAILURE: invio della campagna all'endpoint non riuscito.

  • DAILY_CAP: la campagna non è stata inviata all'endpoint perché all'endpoint è già stato inviato il numero massimo di messaggi giornalieri.

  • EXPIRED: la campagna non è stata inviata all'endpoint perché l'invio ha superato la durata massima o la velocità di invio impostata per la campagna.

  • QUIET_TIME: la campagna non è stata inviata all'endpoint a causa delle limitazioni relative al periodo di silenzio.

  • HOLDOUT: la campagna non è stata inviata all’endpoint perché l'endpoint è un membro del gruppo di esclusione.

  • DUPLICATE_ADDRESS: nel segmento sono presenti indirizzi di endpoint duplicati. La campagna è stata inviata una volta all'indirizzo dell'endpoint.

  • QUIET_TIME: la campagna non è stata inviata all'endpoint a causa delle limitazioni relative al periodo di silenzio.

  • CAMPAIGN_CAP: la campagna non è stata inviata all'endpoint perché all'endpoint è già stato inviato il numero massimo di messaggi dalla campagna in corso.

  • FAILURE_PERMANENT: si è verificato un errore permanente durante l'invio all'endpoint.

  • TRANSIENT_FAILURE: si è verificato un errore temporaneo durante l'invio all'endpoint.

  • THROTTLED: l'invio è stato limitato a livello di larghezza di banda della rete.

  • UNKNOWN: errore sconosciuto.

  • HOOK_FAILURE: hook della campagna non riuscito.

  • CUSTOM_DELIVERY_FAILURE: recapito personalizzato non riuscito.

  • RECOMMENDATION_FAILURE: raccomandazione non riuscita.

  • UNSUPPORTED_CHANNEL: canale non supportato.

Client

Include informazioni sull'endpoint a cui era destinata la campagna.

Attributo Descrizione
client_id L'ID dell'endpoint a cui è stata inviata la campagna.