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

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 messaggi inviati 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 messaggi, consulta e. Flusso di dati sugli eventi di posta elettronica da Amazon Pinpoint SMSflusso di dati sugli eventi 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'JSONoggetto di 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 JSON schema degli eventi.

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

Il SDK che è stato usato 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 di posta elettronica, i ChannelType campi delivery_type and hanno lo stesso valore diEMAIL.

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, ad esempioEMAIL, SMSCUSTOM, e così via. In questo caso, delivery_type identifica un evento di consegna personalizzato e ChannelType specifica il tipo di endpoint a cui è stata inviata la campagna, ad esempio,, e così EMAIL via. CUSTOM SMS CUSTOM 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— La campagna è stata inviata correttamente all'endpoint.

  • FAILURE— La campagna non è stata inviata all'endpoint.

  • 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é il suo invio avrebbe superato la durata massima o le impostazioni relative alla velocità di invio per la campagna.

  • QUIET_ TIME — La campagna non è stata inviata all'endpoint a causa delle restrizioni temporali.

  • HOLDOUT— La campagna non è stata inviata all'endpoint perché l'endpoint faceva parte del gruppo holdout.

  • DUPLICATE_ ADDRESS — Nel segmento sono presenti indirizzi endpoint duplicati. La campagna è stata inviata una volta all'indirizzo dell'endpoint.

  • QUIET_ TIME — La campagna non è stata inviata all'endpoint a causa delle restrizioni relative ai tempi di silenzio.

  • CAMPAIGN_ CAP — La campagna non è stata inviata all'endpoint perché il numero massimo di messaggi è già stato inviato all'endpoint da questa campagna.

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

  • UNKNOWN— Errore sconosciuto.

  • HOOK_ FAILURE — Campaign hook non riuscito.

  • CUSTOM_ DELIVERY _ FAILURE — Consegna personalizzata non riuscita.

  • RECOMMENDATION_ FAILURE — Il programma di raccomandazione non è riuscito.

  • UNSUPPORTED_ CHANNEL — Il 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.