Crear cuenta gratis

Segmentos, topics y tags

Cómo elegir a quién enviar.

Tags

Los dispositivos tienen hasta 50 tags clave/valor que tú defines (plan, ciudad, ultima_compra…):

  • se envían al registrar: tags;
  • se actualizan con PUT /v1/devices/{token}/tags, que fusiona;
  • null borra una clave;
  • replace: true reemplaza todos los tags.

Topics

Temas a los que el dispositivo se suscribe por decisión del usuario, por ejemplo «ofertas» o «noticias»:

  • crearlo: POST /v1/topics;
  • suscribir: POST /v1/devices/{token}/topics/{topic};
  • enviar: target: { type: "topic", name: "ofertas" }.

Segmentos

Filtros guardados, con un constructor visual en el panel y estimación en vivo de cuántos dispositivos alcanzan. Son un árbol Y/O de hasta 3 niveles y 20 condiciones sobre:

platform, language, country, timezone, external_user_id, app_version, last_seen (activo en los últimos N días), tag (con su clave), topic, notifications_enabled y capability.

"target": { "type": "filters", "rules": {
  "op": "and",
  "conditions": [
    { "field": "language", "operator": "in", "value": ["es"] },
    { "field": "tag", "key": "plan", "operator": "eq", "value": "gold" },
    { "field": "last_seen", "operator": "within_days", "value": 30 }
  ]
} }

Para reutilizarlo, guárdalo como segmento en el panel y envía con { "type": "segment", "segmentId": "…" }.

Usuarios

Si identificas los dispositivos con externalUserId, puedes enviar por usuario, sin manejar tokens:

"target": { "type": "external_users", "ids": ["cliente-123"] }

Le llega a todos sus dispositivos.