Publicación de notificaciones de Amazon SNS con cargas útiles específicas de la plataforma

Puede utilizar la Consola de administración de AWS o las API de Amazon SNS para enviar mensajes personalizados con cargas específicas de la plataforma a dispositivos móviles. Para obtener más información acerca del uso de las API de Amazon SNS, consulte Acciones de la API de inserción móvil y el archivo SNSMobilePush.java en snsmobilepush.zip.

Envío de mensajes con formato JSON

Cuando envíe cargas específicas de la plataforma, los datos deben tener un formato de cadenas de pares de clave-valor JSON, con las comillas incluidas entre caracteres de escape.

En los siguientes ejemplos, se muestra un mensaje personalizado para la plataforma de FCM.

{
"GCM": "{\"fcmV1Message\": {\"message\": {\"notification\": {\"title\": \"Hello\", \"body\": \"This is a test.\"}, \"data\": {\"dataKey\": \"example\"}}}}"
}

Envío de mensajes específicos de la plataforma

Además de enviar datos personalizados como pares de clave-valor, puede enviar pares de clave-valor específicos de la plataforma.

En el siguiente ejemplo, se muestra la inclusión de los parámetros de time_to_live y collapse_key después de los pares clave-valor de datos personalizados en el parámetro data de FCM.

{
"GCM": "{\"fcmV1Message\": {\"message\": {\"notification\": {\"title\": \"TitleTest\", \"body\": \"Sample message for Android or iOS endpoints.\"}, \"data\":{\"time_to_live\": 3600,\"collapse_key\":\"deals\"}}}}"
}                    

Para obtener una lista de los pares de clave-valor admitidos en cada uno de los servicios de notificaciones push admitidos en Amazon SNS, consulte lo siguiente:

Envío de mensajes a una aplicación en varias plataformas

Para enviar un mensaje a una aplicación instalada en dispositivos de varias plataformas, como FCM y APNs, primero debe suscribir los puntos de enlace móviles a un tema de Amazon SNS y, a continuación, publicar el mensaje en el tema.

En el siguiente ejemplo, se muestra un mensaje que debe enviarse a puntos de enlace móviles suscritos en APNs, FCM y ADM:

{ 
  "default": "This is the default message which must be present when publishing a message to a topic. The default message will only be used if a message is not present for 
one of the notification platforms.",     
  "APNS": "{\"aps\":{\"alert\": \"Check out these awesome deals!\",\"url\":\"www.amazon.com\"} }",
  "GCM": "{\"data\":{\"message\":\"Check out these awesome deals!\",\"url\":\"www.amazon.com\"}}",
  "ADM": "{\"data\":{\"message\":\"Check out these awesome deals!\",\"url\":\"www.amazon.com\"}}" 
}            

Envío de mensajes a APNs como alertas o notificaciones en segundo plano

Amazon SNS puede enviar mensajes a APNs como notificaciones alert o background (para obtener más información, consulte Inserción de actualizaciones en segundo plano en su aplicación en la documentación de APNs).

Especificación de valores de encabezado APNs personalizada

Se recomienda especificar valores personalizados para el AWS.SNS.MOBILE.APNS.PUSH_TYPE atributo de mensaje reservado mediante la acción de la API Publish de Amazon SNS, SDK de AWS o la AWS CLI. En el siguiente ejemplo de la CLI content-available se establece como 1 y apns-push-type como background para el tema especificado.

aws sns publish \
--endpoint-url https://sns.us-east-1.amazonaws.com \
--target-arn arn:aws:sns:us-east-1:123456789012:endpoint/APNS_PLATFORM/MYAPP/1234a567-bc89-012d-3e45-6fg7h890123i \
--message '{"APNS_PLATFORM":"{\"aps\":{\"content-available\":1}}"}' \
--message-attributes '{ \
  "AWS.SNS.MOBILE.APNS.TOPIC":{"DataType":"String","StringValue":"com.amazon.mobile.messaging.myapp"}, \
  "AWS.SNS.MOBILE.APNS.PUSH_TYPE":{"DataType":"String","StringValue":"background"}, \
  "AWS.SNS.MOBILE.APNS.PRIORITY":{"DataType":"String","StringValue":"5"}}' \
--message-structure json

Inferencia del encabezado de tipo de push de APNs desde la carga

Si no establece el encabezado de APNs apns-push-type, Amazon SNS establece el encabezado en alert o background según la clave content-available en el diccionario de aps de su configuración de carga de APNs con formato JSON.

A continuación se muestra un ejemplo de objeto de configuración sin procesar.

{
  "APNS": "{\"aps\":{\"content-available\":1},\"Foo1\":\"Bar\",\"Foo2\":123}"
}

En este ejemplo, Amazon SNS establece el encabezado de APNs de apns-push-type en background para el mensaje. Cuando Amazon SNS detecta que en el diccionario de apn se encuentra la clave de content-available definida en 1, pero no hay ninguna otra clave que pueda desencadenar las interacciones del usuario, establece el encabezado en background.