Notificaciones de aplicación a usuario

This feature is no longer available for new submissions. This documentation is intended solely for developers with existing games.

Las notificaciones de aplicación a usuario son mensajes cortos de formato libre que puedes enviar a las personas que usan tu aplicación para volver a interactuar con ellas. Son uno de los métodos más eficaces para informar de eventos importantes, invitaciones de amigos o acciones que se deben realizar. Estas notificaciones se utilizan para enviar mensajes a las personas que han dado su autorización a tu aplicación.

Las notificaciones de aplicación a usuario están disponibles para todos los juegos web de Facebook. Las notificaciones solo aparecen en la versión web para ordenador de Facebook. Las aplicaciones pueden enviar notificaciones a las personas que hayan dado su autorización a la aplicación. No se requiere ningún permiso especial o ampliado.

Cuando se entrega una notificación, se ilumina el icono de notificaciones en Facebook y aparece en el desplegable. Las notificaciones aparecen con el icono de la aplicación a la izquierda, intercaladas con otras notificaciones según la ordenación cronológica.

Las notificaciones en sí son cadenas de texto personalizado cortas (hasta 120 caracteres). Puedes hacer referencia a las personas según sus identificaciones específicos de la aplicación de Facebook. Estos se ampliarán para mostrar los nombres reales de las personas, pero no se podrá hacer clic en ellos. Consulta la sección Plantillas de mensajes a continuación para obtener más información.

Cuando las personas hagan clic en la notificación, se les llevará a la URL que especifiques con la notificación.

Implementación

Envío de notificaciones

Las aplicaciones pueden generar notificaciones mediante la emisión de una solicitud HTTP POST a la API Graph /user_id/notifications con app access_token. Puedes encontrar más información si consultas el perímetro de notificaciones de la API Graph.

POST /{recipient_userid}/notifications?access_token=... &template=...&href=...

Parámetros

Parámetro	Descripción
`href`	Ruta relativa o parámetros GET del destino (por ejemplo, `index.html?gift_id=123` o `?gift_id=123`). Se usará para crear una URL de destino absoluta según la configuración de la aplicación. La lógica es que, en la web, si la configuración existe para los juegos en Facebook.com, la URL de destino estará compuesta de la URL de la aplicación del juego y `href`. En caso contrario, la notificación no se mostrará. La URL absoluta incluirá algunos parámetros de seguimiento especiales (`fb_source`, `notif_id`, `notif_t`) a la URL de destino para que los desarrolladores puedan hacer un seguimiento.
`template`	Texto personalizado de la notificación. Consulta la sección Plantillas de mensajes a continuación para obtener más información.
`ref`	Separa las notificaciones en grupos para que se pueda hacer un seguimiento independiente de ellas en los análisis de la aplicación.

Gestión de los valores de devolución

Si la llamada se realiza correctamente, la API Graph da la siguiente respuesta:

{
  "success": true
}

Nota: Cuando predecimos una baja probabilidad de que el destinatario interactúe con la notificación, es posible que la notificación no se le muestre aunque la llamada a la API Graph se haya realizado correctamente.

En caso contrario, la respuesta de la API Graph incluirá un error con el mensaje de excepción correspondiente.

Si el usuario al que intentas enviar la notificación no ha autenticado tu aplicación, recibirás una respuesta como la siguiente:

{
   "error": {
      "message": "(#200) Cannot send notifications to a user who has not installed the app",
      "type": "OAuthException",
      "code": 200
   }
}

Si una persona que intentas etiquetar no ha autenticado tu aplicación, obtendrás la siguiente respuesta:

{
   "error": {
      "message": "(#200) Cannot tag users who have not installed the app",
      "type": "OAuthException",
      "code": 200
   }
}

Si el texto de la plantilla contiene más de 180 caracteres, la API te devolverá un error como el siguiente. Ten en cuenta que cualquier cadena de más de 120 caracteres se truncará.

{
   "error": {
      "message": "(#100) template parameter cannot be longer than 180 characters.",
      "type": "OAuthException",
      "code": 100
   }
}

Nota: Si los usuarios desactivan las notificaciones de tu aplicación, la publicación seguirá realizándose correctamente, pero la notificación no aparecerá en la IU.

Plantillas de mensajes

Los mensajes de las notificaciones son texto libre. La API Graph acepta un máximo de 180 caracteres en el campo message y truncará los mensajes a partir de los 120 caracteres.

Mensajes de texto sin formato

Esta notificación se puede generar con la siguiente llamada a la API Graph:

POST /{recipient_userid}/notifications?
     access_token=...& 
     href=...& 
     template=You have people waiting to play with you, play now!

Plantillas de mensajes personalizados

Utiliza @[USER_ID] para incluir valores de user_id, que se reemplazarán por el nombre completo del usuario y se resaltarán en el momento de la representación.

La notificación anterior se puede generar si se aplica formato a la plantilla con los identificadores de usuario, tal como se muestra en el código siguiente.

POST /{recipient_userid}/notifications?
     access_token=...& 
     href=...& 
     template=@[596824621] started a game with you, play now!

Del mismo modo, la siguiente notificación también utiliza la sintaxis @[USER_ID], pero tiene más de un actor (persona) en la plantilla.

POST /{recipient_userid}/notifications?
     access_token=...& 
     href=...& 
     template=@[596824621] and @[10149999096285761] started a game with you!

La API Graph verifica cada valor de USER_ID para asegurarse de que es un usuario de Facebook válido y ya ha autenticado tu aplicación. Si ninguno es válido, se generará un error en la llamada a la API.

Seguimiento del rendimiento

Porcentaje de clics mínimo

El porcentaje de clics (CTR) es una de las medidas más importantes de la efectividad de las notificaciones. Las notificaciones que tienen un CTR alto resultan interesantes y atractivas para las personas. Las notificaciones con un CTR bajo se consideran de baja calidad. Con el tiempo, los usuarios tenderán a ignorar o desactivar las notificaciones de CTR bajo, lo que perjudicará no solo el rendimiento de tu aplicación, sino también el de otras.

Para asegurarse que el canal de notificaciones siga siendo interesante para los usuarios de Facebook, las aplicaciones que envían más de 50 000 notificaciones a la semana deben mantener al menos un porcentaje de clics (CTR) semanal del 17 %. Los datos demuestran que las personas interactúan más tiempo cuando las aplicaciones mantienen este porcentaje o uno mayor. Las aplicaciones que no mantienen este porcentaje semanalmente pueden desactivarse temporalmente.

La mayoría de las aplicaciones pueden mantener este porcentaje con bastante facilidad si siguen las prácticas recomendadas sencillas que se indican en la siguiente sección.

Optimización manual

Localización de la plantilla de mensaje

Para enviar notificaciones que no estén en inglés, los desarrolladores necesitan hacer un seguimiento manual de la configuración regional del usuario. Cuando el usuario inicia sesión, se puede acceder a la configuración regional mediante el perímetro de la API Graph /{user-id}?fields=locale. En el caso de los juegos en Facebook.com, la información de la configuración regional puede recuperarse de la solicitud HTTP POST. Si conocen la configuración regional, los desarrolladores pueden crear manualmente plantillas de mensajes que se correspondan con la configuración regional del usuario.

Horario de envío

Los desarrolladores pueden optimizar mejor las notificaciones para que se envíen mientras el usuario esté despierto. Cuando el usuario inicia sesión, se puede acceder a la zona horaria mediante el perímetro de la API Graph /{user-id}?fields=timezone. Con la información de la zona horaria y los parámetros de referencia, los desarrolladores pueden mejorar la segmentación y la optimización para saber el mejor momento en el que enviar notificaciones a los usuarios.

Segmentación automática (beta)

La segmentación automática te permite enviar notificaciones de aplicación a usuario mientras utilizas la segmentación mejorada de Facebook. La activación de la segmentación automática te libera de tener que mantener un porcentaje de clics (CTR) alto del 17 % tú mismo, ya que Facebook entregará automáticamente las notificaciones a las personas que tienen más probabilidades de interactuar con tu aplicación.

Con esta función activada, puedes dirigirte a segmentos de audiencia más grandes con las notificaciones y Facebook las enviará automáticamente a las personas que tienen más probabilidades de interactuar con tu aplicación. Por ejemplo, hemos identificado que las notificaciones que tienen más de unos días suelen tener un rendimiento bajo y, por lo tanto, entregaremos menos de esas. La mayoría de los desarrolladores que han activado la segmentación automática y han aumentado los envíos de notificaciones han visto grandes aumentos en la interacción con las notificaciones de aplicación a usuario.

Para usar la segmentación automática, puedes activarla en la pestaña Configuración de Configuración del panel de aplicaciones.

Ten en cuenta que, en el caso de las aplicaciones que no usaron las notificaciones de aplicación a usuario en el pasado y las han implementado recientemente, se activará automáticamente la segmentación automática.

Prácticas recomendadas

Dado que la calidad es muy importante, los destinatarios de Facebook pueden desactivar fácilmente las notificaciones que no les gusten o denunciarlas como spam. Usamos estas señales para promocionar las notificaciones que les gustan a los usuarios y reducir la distribución de las notificaciones que no les gustan. Esto ayuda a mantener las notificaciones útiles para todos.

Los usuarios no diferencian las notificaciones del resto de su experiencia en Facebook, por lo que cada mensaje tiene mucho poder. Un mensaje no deseado puede hacer que alguien empiece a ignorar las notificaciones o las desactive totalmente.

Para ayudarte a crear notificaciones claras y atractivas, hemos reunido estas prácticas recomendadas.

No te dirijas a usuarios inactivos. La aplicación no debe enviar notificaciones a usuarios que no la hayan utilizado en los últimos 28 días. Los datos demuestran que la interacción entre este grupo es significativamente menor. También son los que tienen más probabilidades de denunciar las notificaciones como spam. Las aplicaciones que reciben una cantidad elevada de denuncias de spam pueden desactivarse.
Empieza poco a poco. Incluso si tienes una gran aplicación, empieza probando las notificaciones en algunos usuarios para mantenerte por debajo del umbral de 50 000 a la semana. De esta manera, podrás experimentar con las notificaciones hasta que aprendas qué es lo que mejor funciona para los usuarios.
Envía solo una o dos notificaciones a las personas al día. Al superar las dos notificaciones al día, muchas personas dejan de responder o marcan las aplicaciones como spam.
No canses a la audiencia. Por lo general, no es una buena práctica enviar demasiadas notificaciones a la misma persona en un periodo de tiempo breve. Con los análisis de la aplicación, los desarrolladores pueden encontrar el punto ideal para volver a interactuar con los jugadores al comparar los resultados con parámetros de referencia de diferentes horarios: dos horas, seis horas, un día, tres días, una semana o incluso hasta dos semanas.
Segmentación automática. Si envías más de 50 000 notificaciones a la semana y tienes dificultades para mantener el CTR del 17 %, debes activar la segmentación automática para dejar que Facebook entregue automáticamente las notificaciones a las personas que tienen más probabilidades de interactuar con tu aplicación.