Eventi SMS

Se in un progetto è abilitato il canale SMS, Amazon Pinpoint può eseguire lo streaming dei dati di eventi relativi ai recapiti dei messaggi SMS per il progetto. La ricezione degli eventi SMS generati dagli operatori può richiedere fino a 72 ore. Tali eventi non devono essere utilizzati per determinare se esiste un ritardo nel recapito dei messaggi in uscita. Dopo 72 ore, se Amazon Pinpoint non ha ricevuto un evento finale da un operatore, il servizio restituirà automaticamente un valore record_status UNKNOWN poiché non è noto cosa sia successo a tale messaggio. Prima di poter visualizzare i tuoi eventi devi configurare lo streaming degli eventi, vediConfigurazione dello streaming degli eventi. Quando configuri lo streaming degli eventi, specifichi una destinazione in cui salvare i dati dell'evento, quindi puoi utilizzare la destinazione per recuperare i dati dell'evento per la visualizzazione.

Esempio

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

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

Attributi di eventi SMS

Questa sezione definisce gli attributi inclusi nei dati del flusso di eventi generati da Amazon Pinpoint quando invii messaggi SMS.

Evento
Attributo	Descrizione
event_type	Tipo di evento. I valori possibili sono: _SMS.BUFFERED: il messaggio non è ancora stato recapitato al destinatario. _SMS.SUCCESS: il messaggio è stato correttamente accettato dall'operatore/recapitato al destinatario. _SMS.FAILURE: Amazon Pinpoint non è stato in grado di recapitare il messaggio al destinatario. Per ulteriori informazioni sull'errore che ha impedito il recapito del messaggio, consulta attributes.record_status. _SMS.OPTOUT: il cliente ha ricevuto il messaggio e ha risposto inviando la parola chiave di opt-out (in genere "STOP").
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 sul client dell'app installato nel dispositivo che ha segnalato l'evento. Per ulteriori informazioni, consulta la tabella Client.
device	Informazioni sul dispositivo che ha segnalato l'evento. Per ulteriori informazioni, consulta la tabella Dispositivo. Per gli eventi SMS, questo oggetto è vuoto.
session	Per gli eventi SMS, 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.
metrics	Parametri aggiuntivi associati all'evento. Per ulteriori informazioni, consulta la tabella Parametri.
awsAccountId	L'ID dell' AWS account utilizzato per inviare il messaggio.

Applicazione

Include informazioni sul progetto Amazon Pinpoint a cui è associato l'evento e, se applicabile, sull'SDK utilizzato per segnalare 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. Se invii un messaggio SMS transazionale chiamando direttamente l'API Amazon Pinpoint o utilizzando la console Amazon Pinpoint, questo oggetto è vuoto.

Attributes

Include informazioni sugli attributi associati all'evento.

Attributo	Descrizione
sender_request_id	Un ID univoco associato alla richiesta di invio del messaggio SMS.
campaign_activity_id	L'ID univoco dell'attività all'interno della campagna.
origination_phone_number	Il numero di telefono da cui è stato inviato il messaggio.
destination_phone_number	Il numero di telefono a cui hai tentato di inviare il messaggio.
record_status	Ulteriori informazioni sullo stato del messaggio. I valori possibili includono: SUCCESSFUL/DELIVERED: il recapito del messaggio è riuscito. PENDING: il messaggio non è stato ancora recapitato al dispositivo del destinatario. INVALID: il numero di telefono di destinazione non è valido. UNREACHABLE: il dispositivo del destinatario è attualmente irraggiungibile o non disponibile. Ad esempio, il dispositivo potrebbe essere spento o disconnesso dalla rete. Puoi provare a inviare nuovamente il messaggio in un secondo momento. UNKNOWN: si è verificato un errore che ha impedito il recapito del messaggio. Questo errore è in genere transitorio e puoi tentare di inviare nuovamente il messaggio in un secondo momento. BLOCKED: il dispositivo del destinatario sta bloccando i messaggi SMS dal numero di origine. CARRIER_UNREACHABLE: un problema a livello di rete mobile del destinatario ha impedito il recapito del messaggio. Questo errore è in genere transitorio e puoi tentare di inviare nuovamente il messaggio in un secondo momento. SPAM: l'operatore di telefonia mobile del destinatario ha identificato il contenuto del messaggio come spam e ha bloccato il recapito del messaggio. INVALID_MESSAGE: il corpo del messaggio SMS non è valido e non può essere recapitato. CARRIER_BLOCKED: l'operatore del destinatario ha bloccato il recapito di questo messaggio. Ciò si verifica spesso quando il carrier identifica il contenuto del messaggio come non richiesto o dannoso. TTL_EXPIRED: non è stato possibile recapitare il messaggio SMS entro un determinato intervallo di tempo. Questo errore è in genere transitorio e puoi tentare di inviare nuovamente il messaggio in un secondo momento. MAX_PRICE_EXCEEDED: l'invio del messaggio comporta un addebito che supera la quota mensile di spesa per SMS per il tuo account. Puoi richiedere un aumento di questa quota completando la procedura descritta in Richiesta di aumento della quota di spesa mensile per l'invio di SMS per Amazon SNS nella Guida per l'utente di Amazon Pinpoint. OPTED_OUT : il messaggio SMS non è stato inviato perché il destinatario ha scelto mediante opt-out di non ricevere messaggi da te. NO_QUOTA_LEFT_ON_ACCOUNT: sul tuo account non è disponibile una quota di spesa sufficiente per inviare il messaggio. Puoi richiedere un aumento di questa quota completando la procedura in Richiesta di aumenti della quota di spesa mensile per SMS nella Amazon Pinpoint SMS User Guide. NO_ORIGINATION_IDENTITY_AVAILABLE_TO_SEND: il tuo account non contiene un numero di telefono utilizzabile per inviare il messaggio alla destinazione. DESTINATION_COUNTRY_NOT_SUPPORTED: il paese di destinazione è bloccato. Per tutti i paesi supportati, consulta Paesi e regioni supportati (canale SMS) nella Guida per l'utente di Amazon Pinpoint SMS. ACCOUNT_IN_SANDBOX: il tuo account si trova in un ambiente di sperimentazione (sandbox) e può inviare messaggi solo a numeri di destinazione verificati. Puoi verificare il numero di destinazione nella console Amazon Pinpoint o avviare il processo per spostare l'account dalla sandbox. Vedi Passare dalla sandbox di Amazon Pinpoint SMS alla produzione nella Guida per l'utente di Amazon Pinpoint SMS. RATE_EXCEEDED: hai tentato di inviare un messaggio troppo velocemente e si è verificata una limitazione (della larghezza di banda della rete). Devi rallentare la frequenza delle chiamate. Per informazioni dettagliate sui nostri limiti, consulta i limiti MPS (Message Parts per Second) nella Guida per l'utente di Amazon Pinpoint SMS. INVALID_ORIGINATION_IDENTITY: l'identità di origine specificata non è valida. ORIGINATION_IDENTITY_DOES_NOT_EXIST: l'identità di origine specificata non esiste. INVALID_DLT_PARAMETERS: sono stati specificati parametri DLT non validi (obbligatori per le destinazioni in India). INVALID_PARAMETERS: sono stati specificati parametri non validi. ACCESS_DENIED: al tuo account è impedito l'invio di messaggi. Contatta il Supporto clienti per scoprire la causa e risolvere il problema. INVALID_KEYWORD: la parola chiave specificata non è valida. È possibile che la parola chiave abbia un formato errato o non sia stata impostata nel tuo account. INVALID_SENDER_ID: l'ID mittente specificato non è valido. È possibile che l'ID mittente abbia un formato o una lunghezza errati. INVALID_POOL_ID: l'ID del pool specificato non è valido. È possibile che l'ID del pool sia essere in un formato errato o non appartenga al tuo account. SENDER_ID_NOT_SUPPORTED_FOR_DESTINATION: il paese di destinazione non supporta l'ID mittente. È necessario utilizzare un numero di telefono o un'altra identità di origine per l'invio. INVALID_PHONE_NUMBER: il numero di telefono di origine specificato non è valido. È possibile che il numero di telefono abbia un formato o una lunghezza errati.
iso_country_code	Il paese associati al numero di telefono del destinatario, mostrati nel formato ISO 3166-1 alpha-2.
treatment_id	L'ID della descrizione (treatment) del messaggio, se il messaggio è stato inviato in una campagna A/B.
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 i messaggi SMS transazionali, questo valore è 0.
number_of_message_parts	Numero di parti di messaggio che Amazon Pinpoint ha creato per inviare il messaggio. In genere, i messaggi SMS possono contenere solo 160 caratteri GSM-7 o 67 caratteri non GSM, anche se questi limiti possono variare in base al paese . Se invii un messaggio che supera questi limiti, Amazon Pinpoint lo suddivide automaticamente in parti più piccole. I costi vengono fatturati in base al numero di parti del messaggio inviate.
message_id	ID univoco che Amazon Pinpoint genera quando accetta il messaggio.
message_type	Il tipo di messaggio. I valori possibili sono Promotional (Promozionale) e Transactional (Transazionale). Specifichi questo valore quando crei una campagna o quando invii messaggi transazionali utilizzando l'SendMessagesoperazione nell'API Amazon Pinpoint.
campaign_id	ID univoco della campagna Amazon Pinpoint che ha inviato il messaggio.

Client

Include informazioni sul client dell'app installato nel dispositivo che ha segnalato l'evento.

Attributo	Descrizione
client_id	Per gli eventi generati dalle app, questo valore è l'ID univoco del client dell'app installato sul dispositivo. Questo ID viene generato automaticamente da e da. AWS Mobile SDK for iOS AWS Mobile SDK for Android Per gli eventi generati quando invii campagne e messaggi transazionali, questo valore è uguale all'ID dell'endpoint a cui hai inviato il messaggio.
cognito_id	ID univoco assegnato al client dell'app nel pool di identità Amazon Cognito utilizzato dall'app.

Dispositivo

Include informazioni sul dispositivo che ha segnalato l'evento.

Attributo	Descrizione
locale	Le impostazioni locali del dispositivo.
make	La marca del dispositivo, ad esempio Apple o Samsung.
model	Il modello del dispositivo, ad esempio iPhone.
platform	La piattaforma del dispositivo, ad esempio ios o android.

Metriche

Include informazioni sui parametri associati all'evento.

Attributo	Descrizione
price_in_millicents_usd	L'importo addebitato per l'invio del messaggio. Questo prezzo è indicato in millesimi di un centesimo degli Stati Uniti. Ad esempio, se il valore di questo attributo è 645, vengono addebitati 0,645 ¢ per l'invio del messaggio (645/1000=0,645¢=$0,00645). Nota Questa proprietà non viene visualizzata per i messaggi con un event_type di _SMS.BUFFERED.