As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Eventos de campanha
Se o Amazon Pinpoint for usado para enviar campanhas através de qualquer canal, o Amazon Pinpoint pode transmitir dados de eventos sobre essas campanhas. Isso inclui dados de eventos para quaisquer mensagens de email ou SMS enviadas de uma campanha. Para obter informações detalhadas sobre os dados transmitidos pelo Amazon Pinpoint para esses tipos de mensagens, consulte Eventos de e-mail e SMSeventos. Antes de poder ver seus eventos, você precisa configurar o streaming de eventos, consulteConfigurar streaming de eventos. Ao configurar o streaming de eventos, você especifica um destino para os dados do evento serem salvos e, em seguida, pode usar o destino para recuperar os dados do evento para visualização.
Evento de exemplo
O objeto JSON para uma campanha contém os dados mostrados no exemplo a seguir.
{ "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" }
Atributos de eventos de campanha
Esta seção define os atributos incluídos nos eventos de streaming da campanha.
Atributo | Descrição |
---|---|
event_type |
O tipo de evento. Os valores possíveis são:
|
event_timestamp |
A hora em que o evento foi relatado, mostrada como horário do Unix em milissegundos. |
arrival_timestamp |
A hora em que o evento foi recebido pelo Amazon Pinpoint, mostrada como horário do Unix em milissegundos. |
event_version |
A versão do esquema do evento JSON. dicaMarque esta versão no seu aplicativo de processamento de eventos para que você saiba quando atualizar o aplicativo em resposta a uma atualização de esquema. |
application |
Informações sobre o projeto do Amazon Pinpoint associado ao evento. Para obter mais informações, consulte a tabela Aplicativo. |
client |
Informações sobre o endpoint ao qual o evento está associado. Para obter mais informações, consulte a tabela Cliente. |
device |
Informações sobre o dispositivo que relatou o evento. Para campanhas e mensagens transacionais, esse objeto está vazio. |
session |
Informações sobre a sessão que gerou o evento. Para campanhas, esse objeto está vazio. |
attributes |
Atributos associados ao evento. Para eventos relatados por um de seus aplicativos, esse objeto pode incluir atributos personalizados que são definidos pelo aplicativo. Para eventos criados ao enviar uma campanha, esse objeto contém atributos associados à campanha. Para eventos gerados ao enviar mensagens transacionais, esse objeto contém informações relacionadas à mensagem em si. Para obter mais informações, consulte a tabela Atributos. |
client_context |
Contém um objeto custom , que contém uma propriedade endpoint . A propriedade endpoint tem o conteúdo do registro de endpoint para o endpoint ao qual a campanha foi enviada. |
awsAccountId |
O ID da AWS conta que foi usada para enviar a mensagem. |
Aplicativo
Inclui informações sobre o projeto do Amazon Pinpoint ao qual o evento está associado.
Atributo | Descrição |
---|---|
app_id |
O ID exclusivo do projeto do Amazon Pinpoint que relatou o evento. |
sdk |
O SDK usado para relatar o evento. |
Atributos
Inclui informações sobre a campanha que produziu o evento.
Atributo | Descrição |
---|---|
treatment_id |
Se a mensagem foi enviada usando uma campanha de teste A/B, esse valor representa o número de tratamento da mensagem. Para campanhas padrão, esse valor é |
campaign_activity_id |
O ID exclusivo que o Amazon Pinpoint gera quando o evento ocorre. |
delivery_type |
O método de entrega da campanha. Não confunda esse atributo com o campo Para canais que oferecem suporte a apenas um tipo de endpoint, os campos No entanto, essa condição nem sempre é verdadeira para canais que oferecem suporte a diferentes tipos de endpoints, como canais personalizados. Você pode usar um canal personalizado para diferentes endpoints, como EMAIL, SMS, CUSTOM e assim por diante. Nesse caso, Os valores possíveis são:
|
campaign_id |
O ID exclusivo da campanha da qual a mensagem foi enviada. |
campaign_send_status |
Indica o status da campanha para o endpoint de destino. Os possíveis valores incluem:
|
Cliente
Inclui informações sobre o endpoint que foi direcionado pela campanha.
Atributo | Descrição |
---|---|
client_id |
O ID do endpoint para o qual a campanha foi enviada. |