SMSflusso di dati sugli eventi da Amazon Pinpoint - Amazon Pinpoint
SMSesempio di eventoSMSattributi dell'evento

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à.

SMSflusso di dati sugli eventi da Amazon Pinpoint

Se il SMS canale è abilitato per un progetto, Amazon Pinpoint può trasmettere dati sugli eventi relativi alle consegne di SMS messaggi per il progetto. Dopo aver configurato lo streaming degli eventi, Amazon Pinpoint recupera i dati degli eventi dalla destinazione specificata durante la configurazione per consentirti di visualizzarli. Per informazioni su come configurare lo streaming degli eventi, consulta. Configura Amazon Pinpoint per lo streaming dei dati degli eventi delle app tramite Amazon Kinesis o Amazon Data Firehose

Nota

SMSgli eventi generati dai corrieri possono richiedere fino a 72 ore per essere ricevuti e non devono essere utilizzati per determinare se c'è un ritardo nella consegna dei messaggi in uscita. Dopo 72 ore, se Amazon Pinpoint non ha ricevuto un evento finale da un corriere, il servizio restituisce automaticamente un UNKNOWN record_status, poiché Amazon Pinpoint non sa cosa è successo a quel messaggio.

SMSesempio di evento

L'JSONoggetto di un SMS evento 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": "+12065550142",
    "destination_phone_number": "+14255550199",
    "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"
}

SMSattributi dell'evento

Questa sezione definisce gli attributi inclusi nell'esempio precedente dei dati del flusso di eventi che Amazon Pinpoint genera quando SMS invii messaggi.

Evento
Attributo Descrizione
event_type

Tipo di evento. I valori possibili sono:

  • _SMS. BUFFERED— Il messaggio è ancora in fase di consegna al destinatario.

  • _SMS. SUCCESS— Il messaggio è stato accettato con successo dal corriere/consegnato 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 (di solito "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 degli eventiJSON.

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 SMS gli eventi, questo oggetto è vuoto.
session Per SMS gli eventi, 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, le SDK informazioni utilizzate per segnalare l'evento.

Attributo Descrizione
app_id

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

Il SDK che è stato utilizzato per segnalare l'evento. Se invii un SMS messaggio transazionale chiamando direttamente Amazon API 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 messaggio è stato recapitato correttamente.

  • PENDING— Il messaggio non è ancora stato recapitato sul 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 la consegna 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 SMS i messaggi provenienti dal numero di origine.

  • CARRIER_ UNREACHABLE — Un problema con la rete mobile del destinatario ha impedito la consegna 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 ne ha bloccato la consegna.

  • INVALID_ MESSAGE — Il corpo del SMS messaggio non è valido e non può essere recapitato.

  • CARRIER_ BLOCKED — Il corriere del destinatario ha bloccato la consegna di questo messaggio. Ciò si verifica spesso quando il carrier identifica il contenuto del messaggio come non richiesto o dannoso.

  • TTL_ EXPIRED — Il SMS messaggio non può essere consegnato entro un determinato periodo 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 avrebbe comportato un addebito superiore alla quota di SMS spesa mensile prevista per il tuo account. Puoi richiedere un aumento di questa quota completando la procedura in Richiesta di aumenti della quota di SMS spesa mensile nella Guida per l'utente di Amazon Pinpoint.

  • OPTED_ OUT — Il SMS messaggio non è stato inviato perché il destinatario ha scelto di non ricevere messaggi da te.

  • NO_ QUOTA _ LEFT _ON_ ACCOUNT — Sul tuo account non è rimasta una quota di spesa sufficiente per inviare il messaggio. Puoi richiedere un aumento di questa quota completando la procedura riportata in Richiesta di aumenti della quota di SMS spesa mensile nella Guida per l'utente della messaggistica con l'utente AWS finale. SMS

  • NO_ ORIGINATION _ IDENTITY _ AVAILABLE _TO_ SEND — Il tuo account non contiene un numero di telefono che possa essere utilizzato per inviare il messaggio alla destinazione.

  • DESTINATION_ _ COUNTRY NOT _ SUPPORTED — Il paese di destinazione è bloccato. Per tutti i paesi supportati, consulta Paesi e aree geografiche supportati (SMScanale) nella Guida per l'utente dei servizi di messaggistica per SMS l'utente AWS finale.

  • ACCOUNT_IN_ SANDBOX — Il tuo account è nella 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 Informazioni sulla sandboxSMS/MMSand Voice nella Guida per l'utente di AWS End User Messaging. SMS

  • RATE_ EXCEEDED — Hai tentato di inviare un messaggio troppo velocemente e sei stato bloccato. Devi rallentare la frequenza delle chiamate. Per informazioni dettagliate sui nostri limiti, consulta Message Parts per Second (MPS) limits nella Guida per l'utente della messaggistica SMS per l'utente AWS finale.

  • INVALID_ ORIGINATION _ IDENTITY — L'identità di origine fornita non è valida.

  • ORIGINATION_ IDENTITY _ DOES _ NOT _ EXIST — L'identità di origine fornita non esiste.

  • INVALID_ DLT _ PARAMETERS — Sono stati forniti DLT parametri non validi (obbligatori per le destinazioni in India).

  • INVALID_ PARAMETERS — Sono stati forniti parametri non validi.

  • ACCESS_ DENIED — Al tuo account è bloccato l'invio di messaggi. Contatta il Supporto clienti per scoprire la causa e risolvere il problema.

  • INVALID_ KEYWORD — La parola chiave fornita 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 fornito non è valido. È possibile che l'ID mittente abbia un formato o una lunghezza errati.

  • INVALID_ POOL _ID — L'ID del pool fornito 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 fornito non è valido. È possibile che il numero di telefono abbia un formato o una lunghezza errati.
iso_country_code

Il paese associato al numero di telefono del destinatario, mostrato nel formato ISO 3166-1 alfa-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 SMS messaggi transazionali, questo valore è 0.
number_of_message_parts

Numero di parti di messaggio che Amazon Pinpoint ha creato per inviare il messaggio.

In genere, SMS i messaggi possono contenere solo GSM 160-7 caratteri o 67 non GSM caratteri, sebbene questi limiti possano variare in base al paese all'area geografica. 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 in Amazon Pinpoint. API
campaign_id

ID univoco della campagna Amazon Pinpoint che ha inviato il messaggio.
customer_context

Una JSON stringa del contenuto della Context mappa inviata in un'operazione Amazon Pinpoint SendMessages.

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 AWS Mobile SDK for iOS e da. 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 segno event_type di _SMS. BUFFERED.