API de tags de objeto (beta)
Los tags de objeto almacenan datos estructurados sobre un usuario en un solo tag. Un tag de tipo Object contiene un objeto con campos con nombre, como el último order con su amount y su status. Un tag de tipo ObjectList contiene un array de esos objetos, como todos los orders. Un campo puede ser a su vez un objeto o una lista de objetos, como la address de un profile. Defines los campos una vez, escribes y lees los valores a través de la API de tags, creas segmentos según los valores de los campos e insertas los valores en los mensajes con Liquid.
Cómo funcionan los tags de objeto
Anchor link toUn tag de objeto tiene un esquema y un valor. El esquema es el nombre del tag y una lista de campos, cada uno con su propio tipo. El valor se almacena en los campos, por separado para cada usuario.
- Campo. Cada campo es un tag con el nombre
<object>.<field>, por ejemploorder.amount. Segmentas por campos, y puedes escribir un campo de un tagObjectusando este nombre. - Valor
Object. Un objeto por usuario, por ejemplo"order": {"amount": 120, "status": "paid"}. - Valor
ObjectList. Un array de objetos con los mismos campos, por ejemplo"orders": [{"amount": 120, "status": "paid"}, {"amount": 50}]. - Objeto anidado. Un campo de tipo
OBJECTcon campos propios, por ejemploprofile.addresscon el campoprofile.address.city. - Lista anidada. Un campo de tipo
OBJECT_LIST, un array de objetos dentro de un tag de objeto, por ejemploprofile.visits. Consulta Objetos y listas anidados.
En la API, los tipos de tag y de campo son OBJECT y OBJECT_LIST. En el Panel de Control son Objeto y Lista de objetos. En esta página, una lista de objetos significa un tag ObjectList o una lista anidada.
Los tags de objeto siempre son User-specific, lo que significa que el valor pertenece al usuario, no a un único dispositivo, y se copia en todos los dispositivos del usuario. Consulta la API de Tags para los tags normales.
Objetos y listas anidados
Anchor link toUn campo de un tag de objeto puede contener sus propios campos en lugar de un único valor. Un objeto anidado, un campo de tipo OBJECT, contiene un objeto. Una lista anidada, un campo de tipo OBJECT_LIST, contiene una lista de objetos. Un elemento de una lista también puede contener objetos anidados y listas anidadas. Cada campo conserva su nombre completo con puntos, como profile.address.city, y segmentas por estos nombres.
Por ejemplo, un tag profile de tipo OBJECT y un tag orders de tipo OBJECT_LIST pueden tener esta estructura:
profile OBJECT├── address OBJECT│ ├── city STRING│ └── geo OBJECT│ └── lat STRING└── visits OBJECT_LIST └── code STRING
orders OBJECT_LIST├── sku STRING├── meta OBJECT│ └── color STRING└── lines OBJECT_LIST └── qty INTEGERCampos con búsqueda y campos solo almacenados
Anchor link toLo que puedes hacer con un campo depende de cuántas listas de objetos hay por encima de él:
- Ninguna lista por encima del campo. Puedes segmentar por un campo como
profile.address.city, escribirlo por separado con su nombre completo y usarlo en los mensajes. - Una lista por encima del campo. Puedes segmentar por un campo como
profile.visits.codeuorders.meta.colory usarlo en los mensajes. Escríbelo solo como parte de la lista completa. - Dos listas por encima del campo. Un campo como
orders.lines.qtysolo se almacena. Úsalo en los mensajes, pero no en los segmentos.
Límites
Anchor link toPushwoosh aplica estos límites a los tags de objeto, incluidos los objetos anidados y las listas anidadas:
| Límite | Valor | Cuando se supera |
|---|---|---|
| Profundidad de anidamiento | 3 niveles de objetos y listas. El propio tag es el primer nivel, así que profile.address.geo es el objeto más profundo permitido | El método de esquema devuelve HTTP 400, consulta Errores |
| Campos en un objeto | De 1 a 20, para el tag y para cada objeto anidado o lista anidada | El método de esquema devuelve HTTP 400, consulta Errores |
| Campos con valores en un tag de objeto | 50, incluidos los campos anidados. Los campos de tipo OBJECT y OBJECT_LIST no cuentan | El método de esquema devuelve HTTP 400, consulta Errores |
| Nombre completo del campo | 64 caracteres, como profile.address.city | El método de esquema devuelve HTTP 400, consulta Errores |
| Elementos en una lista de objetos | 100, para el tag y para cada lista anidada | Se rechaza todo el valor escrito |
| Tamaño de un valor escrito | 64 KB de JSON | Se rechaza todo el valor escrito |
Un valor rechazado se trata igual que un valor con un tipo de campo incorrecto, consulta Escribir reemplaza el valor completo.
Reglas del esquema
Anchor link toPushwoosh comprueba estas reglas cuando creas un tag de objeto o añades un campo:
- Los nombres de objetos y campos contienen solo letras latinas, dígitos y
_. - El tag y cada objeto anidado o lista anidada tienen de 1 a 20 campos. También se aplican los demás límites. Los nombres de los campos no distinguen entre mayúsculas y minúsculas, por lo que
Amountyamountson el mismo campo. - Un campo tiene uno de estos tipos:
INTEGER,STRING,LIST,DATE,BOOLEAN,PRICE,VERSION,OBJECT,OBJECT_LIST. Un campo de tipoOBJECTuOBJECT_LISTnecesita sus propiosfields. No se admiten campos de zona horaria. - Un campo no puede tomar un nombre que ya tenga otro tag. Si existe un tag
order.note, añadir el camponoteaorderfalla contag order.note already exists. - Un objeto no puede perder su último campo. En su lugar, elimina el objeto.
- No se puede eliminar un campo o un tag de objeto que esté en uso. Un objeto anidado o una lista anidada cuenta como en uso cuando se usa cualquier cosa que contenga. El error indica dónde se usa, por ejemplo
field is in use: segment Big buyers, in-app Spring sale. Cuentan como usos los segmentos, los in-apps, las campañas de Customer Journey en ejecución, los presets, las plantillas de email y otros elementos que hacen referencia al tag.
Gestionar tags de objeto en el Panel de Control
Anchor link toCrea un tag de objeto sin objetos anidados ni listas anidadas en el Panel de Control:
- En la página Etiquetas de tu Panel de Control, haz clic en Crear etiqueta.
- Introduce el Nombre de etiqueta.
- En Tipo de valor, elige Objeto o Lista de objetos.
- En Campos, introduce el nombre del primer campo.
- Elige el tipo del campo.
- Para añadir otro campo, haz clic en Añadir campo.
- Haz clic en Crear.
En la página del tag, añade un campo o haz clic en Eliminar junto a un campo para borrarlo. El Panel de Control no puede crear un objeto anidado ni una lista anidada, ni cambiar sus campos. Muestra un objeto anidado o una lista anidada creados a través de la API como un único campo de tipo Objeto o Lista de objetos. Al eliminar ese campo, se elimina junto con todo lo que contiene.
Gestionar el esquema
Anchor link toCrea y modifica tags de objeto con los métodos REST que se indican a continuación. Usa /json/1.3/addTag solo para tags normales, porque no puede definir campos.
URL base
Anchor link tohttps://rpc-api.svc-nue.pushwoosh.comAutenticación
Anchor link toCada solicitud debe incluir un encabezado Authorization con tu token de API de servidor. Un token de API de dispositivo recibe HTTP 403 a device API token cannot call this method, use an account API token.
Authorization: Api YOUR_API_TOKENEndpoints
Anchor link toEstos métodos gestionan el esquema de los tags de objeto y leen los valores de sus campos:
| Método | Ruta | Descripción |
|---|---|---|
POST | /api/tags | Crear un tag de objeto con sus campos |
GET | /api/tags/{name} | Obtener un tag de objeto con sus campos |
GET | /api/tags | Listar tags. Un tag de objeto viene con todos sus fields, incluidos los anidados, y los campos no se listan como tags separados |
POST | /api/tags/{name}/fields | Añadir un campo a un tag de objeto, a un objeto anidado o a una lista anidada |
DELETE | /api/tags/{name}/fields/{field} | Eliminar un campo, un objeto anidado o una lista anidada |
DELETE | /api/tags/{name} | Eliminar un tag de objeto con todos sus campos |
GET | /api/tags:values | Listar los valores almacenados de un campo, consulta Valores almacenados de un campo |
POST /api/tags devuelve el tag de objeto, y ambos métodos de campos devuelven el objeto indicado en {name} después del cambio, envuelto en {"tag": {...}}. DELETE /api/tags/{name} devuelve {}.
Si los tags de objeto no están habilitados en tu cuenta, POST /api/tags con un tipo de objeto y ambos métodos de campos fallan con HTTP 403 object tags are not enabled for the account. GET /api/tags/{name} y DELETE /api/tags/{name} devuelven HTTP 404 tag not found, y GET /api/tags no lista los tags de objeto. Sin los tags de objeto habilitados no puedes crear ninguno, así que no hay nada en lo que escribir valores.
Crear un tag de objeto
Anchor link toPOST /api/tags
Cuerpo de la solicitud
Anchor link to| Nombre | Tipo | Descripción |
|---|---|---|
| name* | string | Nombre del tag de objeto. |
| type* | string | OBJECT para un objeto u OBJECT_LIST para una lista de objetos. |
| fields* | array | Campos del objeto, de 1 a 20. |
| fields[].name* | string | Nombre del campo. El campo se convierte en el tag <name>.<fields[].name>. |
| fields[].type* | string | Tipo del campo: INTEGER, STRING, LIST, DATE, BOOLEAN, PRICE, VERSION, OBJECT u OBJECT_LIST. |
| fields[].fields | array | Campos de un objeto anidado o una lista anidada, de 1 a 20, en el mismo formato. Obligatorio para los tipos OBJECT y OBJECT_LIST y se ignora en los demás tipos. |
{ "name": "orders", "type": "OBJECT_LIST", "fields": [ { "name": "amount", "type": "INTEGER" }, { "name": "status", "type": "STRING" } ]}{ "tag": { "name": "orders", "type": "OBJECT_LIST", "system": false, "user_specific": true, "has_right_ace_modify": true, "fields": [ { "name": "amount", "type": "INTEGER", "fields": [] }, { "name": "status", "type": "STRING", "fields": [] } ] }}El tag se crea como User-specific independientemente del valor de user_specific. GET /api/tags/{name} devuelve el mismo objeto sin el envoltorio tag. Los campos se ordenan por nombre, y un campo sin campos anidados viene con un array fields vacío.
Para crear objetos anidados y listas anidadas, asigna a un campo el tipo OBJECT u OBJECT_LIST y sus propios fields. Una sola solicitud crea toda la estructura:
{ "name": "profile", "type": "OBJECT", "fields": [ { "name": "address", "type": "OBJECT", "fields": [ { "name": "city", "type": "STRING" }, { "name": "geo", "type": "OBJECT", "fields": [{ "name": "lat", "type": "STRING" }] } ] }, { "name": "visits", "type": "OBJECT_LIST", "fields": [{ "name": "code", "type": "STRING" }] } ]}Los campos anidados se devuelven con nombres relativos a su objeto, como city dentro de address. GET /api/tags/{name} solo acepta el nombre del propio tag. Un nombre anidado como profile.address devuelve HTTP 404 tag not found.
Añadir un campo
Anchor link toPOST /api/tags/{name}/fields
{ "field": { "name": "note", "type": "STRING" }}Para añadir un campo a un objeto anidado o una lista anidada, pon su nombre completo en {name}, por ejemplo POST /api/tags/profile.address/fields o POST /api/tags/profile.visits/fields. El nuevo campo puede ser un objeto anidado o una lista anidada con sus propios fields:
{ "field": { "name": "company", "type": "OBJECT", "fields": [{ "name": "title", "type": "STRING" }] }}Puedes escribir el nuevo campo de inmediato como parte del valor completo del tag. Añadir un campo falla si el objeto ya tiene 20 campos, si el campo supera otro límite o si existe un tag con el nombre completo del campo, consulta Errores.
Eliminar un campo
Anchor link toDELETE /api/tags/{name}/fields/{field}
Por ejemplo, DELETE /api/tags/orders/fields/note elimina el campo orders.note. Para eliminar un campo de un objeto anidado o una lista anidada, pon su nombre completo en {name}: DELETE /api/tags/profile.address/fields/city.
Al eliminar un objeto anidado o una lista anidada se elimina todo lo que contiene: DELETE /api/tags/profile/fields/address también elimina profile.address.city y profile.address.geo. No puedes eliminar el último campo de un objeto, ni un campo, un objeto anidado o una lista anidada que esté en uso, consulta Errores.
Errores
Anchor link toLos errores tienen el formato {"code": <n>, "message": "...", "details": [...]}. Cuando creas un tag de objeto, un mensaje 400 tiene la forma validate: rpc error: code = InvalidArgument desc = <message>, donde <message> es el texto de la tabla. En estos mensajes, <object> es el nombre completo del objeto, como profile.address.
| Estado HTTP | Mensaje | Causa |
|---|---|---|
| 400 | object tag and field names must contain only letters, digits and underscores | Un nombre tiene otro carácter. |
| 400 | <object>: an object needs 1 to 20 fields | Al crear, el tag, un objeto anidado o una lista anidada no tiene campos o tiene más de 20. |
| 400 | an object has at most 20 fields | El objeto al que añades un campo ya tiene 20 campos. |
| 400 | <object>.<field>: objects nest at most 3 levels deep | Un campo OBJECT u OBJECT_LIST quedaría en el cuarto nivel. |
| 400 | an object tag holds at most 50 fields with values, nested ones included | El tag de objeto tendría más de 50 campos con valores. |
| 400 | field <name> is given twice | Dos campos tienen el mismo nombre, sin distinguir mayúsculas y minúsculas. |
| 400 | <object>.<field>: object and field names together cannot be longer than 64 characters | El nombre completo del campo es demasiado largo. |
| 400 | <object>.<field>: field type must be INTEGER, STRING, LIST, DATE, BOOLEAN, PRICE, VERSION, OBJECT or OBJECT_LIST | Tipo de campo no admitido. |
| 400 | an object needs at least one field; delete the object instead | Intentaste eliminar el último campo de un objeto. |
| 400 | field is in use: ..., tag is in use: ... | El campo, algo dentro del objeto anidado o la lista anidada, o el tag de objeto se usa en segmentos, in-apps, campañas de Customer Journey u otros elementos. |
| 403 | object tags are not enabled for the account | Los tags de objeto no están habilitados en la cuenta. |
| 403 | a device API token cannot call this method, use an account API token | La solicitud usa un token de API de dispositivo. |
| 404 | tag not found | GET o DELETE /api/tags/{name}: no existe ese tag, el nombre es un campo o los tags de objeto no están habilitados. |
| 404 | object tag not found, field not found | Métodos de campos: no existe ese tag de objeto, objeto anidado, lista anidada o campo. Un {name} que es un campo con valor también devuelve object tag not found. |
| 409 | tag already exists | Existe un tag con el nombre del tag de objeto. |
| 409 | tag <object>.<field> already exists | Existe un tag con el nombre completo del campo. |
Escribir valores
Anchor link toEscribe los valores de los tags de objeto con /setTags y /bulkSetTags. Estos métodos mantienen su propia autenticación: /setTags recibe un token de API de dispositivo en el encabezado Authorization: Token, y /bulkSetTags recibe el token de acceso a la API en auth. Envía un valor Object como un objeto JSON y un valor ObjectList como un array de objetos:
{ "request": { "application": "XXXXX-XXXXX", "userId": "user_42", "tags": { "order": { "amount": 120, "status": "paid" }, "orders": [ { "amount": 120, "status": "paid" }, { "amount": 50 } ] } }}Si estableces el valor por HWID, se almacena en el usuario de ese dispositivo. POST /api/devices:set_tags en la URL base de los métodos de esquema escribe tags de objeto con las mismas reglas. Su respuesta lista los campos de los objetos como nombres planos, como "profile.address.city".
Un objeto anidado recibe un objeto JSON, y una lista anidada recibe un array de objetos:
"tags": { "profile": { "address": { "city": "Berlin", "geo": { "lat": "52.5" } }, "visits": [{ "code": "v1" }] }, "orders": [ { "sku": "A-1", "meta": { "color": "red" }, "lines": [{ "qty": 2 }, { "qty": 3 }] } ]}Cada campo recibe un valor en el formato de su tipo:
| Tipo de campo | Valor de ejemplo |
|---|---|
INTEGER | 120 |
STRING | "paid" |
LIST | ["gift", "express"] |
DATE | "2026-10-02 22:11" (UTC), "2026-10-02" o un timestamp Unix en segundos |
BOOLEAN | true o false |
PRICE | 19.95 |
VERSION | "1.0.0" |
Escribir reemplaza el valor completo
Anchor link toCada escritura reemplaza el valor almacenado del tag de objeto:
- Un campo que falta en el nuevo valor se elimina. Un campo enviado como
nulltambién se elimina. null,[]o""elimina el valor completo.{}elimina todos los campos de un tagObject.- Una clave que no es un campo del objeto se omite.
- Si el valor de un campo a cualquier profundidad no coincide con el tipo del campo, se rechaza el valor completo del tag y el valor almacenado se mantiene como estaba. Lo mismo ocurre si el valor supera un límite: una lista con más de 100 elementos o más de 64 KB de JSON.
/setTags no informa de un valor rechazado en su respuesta y devuelve HTTP 200. Comprueba el resultado con /getTags o usa /bulkSetTags, que informa de un resultado para cada tag.
Campos ocultos
Anchor link toUn campo oculto es un campo que Pushwoosh marca como oculto para su propio uso. No puedes crear ni ocultar un campo con los métodos de esquema de esta página. /getTags no devuelve los campos ocultos, así que un valor que lees y vuelves a escribir nunca los contiene. Lo que les ocurre en una escritura depende del tipo:
Object. Un campo oculto que falta en el nuevo valor se mantiene, a cualquier profundidad. Un objeto anidado visible que falta en el nuevo valor se elimina con todo lo que contiene, incluidos los campos ocultos. Al eliminar el valor completo también se eliminan los campos ocultos.ObjectList. Escribir la lista reemplaza todos sus elementos, y los campos ocultos de los elementos anteriores se pierden. Un elemento no tiene identificador, así que un elemento nuevo no se puede emparejar con uno anterior. Lo mismo se aplica a una lista anidada.
Escribir parte de un Object
Anchor link toEscribe un único campo, un objeto anidado o una lista anidada de un tag Object por su nombre completo en lugar del valor completo del tag. increment y las demás operaciones de /setTags funcionan con los campos:
"tags": { "order.status": "shipped", "order.amount": { "operation": "increment", "value": 5 }}Lo mismo funciona para un campo de un objeto anidado que solo tiene objetos por encima, como "profile.address.city": "Paris".
Un objeto anidado o una lista anidada que solo tiene objetos por encima se puede escribir por separado con su nombre completo, como profile.address o profile.visits. El valor solo lo reemplaza a él, y el resto de profile se mantiene como estaba. Los límites de 100 elementos y 64 KB se cuentan a partir de este valor:
"tags": { "profile.address": { "city": "Paris" }, "profile.visits": [{ "code": "v2" }]}Nada de lo que está dentro de una lista de objetos se puede escribir por separado, porque no está claro qué elemento cambiar. Esto incluye un campo de un tag ObjectList, como orders.sku, y todo lo que hay dentro de un elemento, como orders.meta o profile.visits.code. /setTags ignora ese valor. En su lugar, envía la lista completa.
Los tags de objeto no se crean automáticamente
Anchor link toUn valor con un objeto o un array de objetos para un tag que no existe se omite. La creación automática de tags no crea tags de objeto, así que primero crea el esquema con POST /api/tags.
Resultados de bulkSetTags
Anchor link toCon detailed=true, el estado de /bulkSetTags devuelve uno de estos resultados para un tag de objeto, además de ok, tag not found y wrong value. expect :<type>:
| Resultado | Causa |
|---|---|
object tags are stored on the user only | El tag de objeto no es User-specific. |
cannot load the fields of the object | Pushwoosh no pudo leer los campos del tag de objeto. |
wrong value. expect an object (a map) or, for a list of objects, an array of maps | El valor no encaja con el tag de objeto, el valor de un campo a cualquier profundidad no coincide con su tipo, o el valor supera un límite. |
a field of a list of objects cannot be set on its own, set the whole list | El valor se establece en algo que está dentro de una lista de objetos, como orders.sku u orders.meta. |
Leer valores
Anchor link to/getTags devuelve un valor Object como un objeto JSON y un valor ObjectList como un array de objetos:
{ "status_code": 200, "status_message": "OK", "response": { "result": { "order": { "amount": 120, "status": "paid" }, "orders": [ { "amount": 120, "status": "paid" }, { "amount": 50 } ] } }}Los objetos anidados y las listas anidadas se devuelven a cualquier profundidad con la misma forma en que los escribes, por ejemplo "profile": {"address": {"city": "Berlin"}, "visits": [{"code": "v1"}]}.
Los valores de los campos se devuelven igual que los valores de los tags normales en /getTags: un Date como timestamp Unix en segundos, un Price como cadena, por ejemplo "120.00", y un Boolean como 1 o 0.
Valores almacenados de un campo
Anchor link toGET /api/tags:values en la URL base lista los valores distintos que contiene un campo, con el número de suscriptores de cada valor. Pasa el nombre completo del campo en name, como profile.address.city u orders.sku.
Parámetros de consulta
Anchor link to| Nombre | Tipo | Descripción |
|---|---|---|
| application* | string | Código de la aplicación, XXXXX-XXXXX. |
| name* | string | Nombre completo del campo. |
| like | string | Devolver solo los valores que contienen este texto, en la posición indicada por like_op. |
| like_op | string | STARTS_WITH (predeterminado), ENDS_WITH o CONTAINS. |
| order_by | string | VALUE (predeterminado) o COUNT. |
| order_direction | string | ASC (predeterminado) o DESC. |
| limit | integer | Número de valores que se devuelven. El valor predeterminado es 100. |
| offset | integer | Número de valores que se omiten. |
| page | integer | Número de página, empezando por 0. Se usa con per_page en lugar de limit y offset. |
| per_page | integer | Número de valores por página. |
GET /api/tags:values?application=XXXXX-XXXXX&name=orders.sku&order_by=COUNT&order_direction=DESC{ "values": [ { "value": "A-1", "count": 120 }, { "value": "B-2", "count": 45 } ], "total": 2, "page": 0, "per_page": 100}Los campos Integer y Price no devuelven valores, igual que los tags normales de estos tipos. Un tag de objeto, un objeto anidado o una lista anidada no tiene valores propios, así que su nombre devuelve HTTP 404 tag not found.
Segmentar por campos
Anchor link toEstablece las condiciones del segmento sobre los campos, no sobre el propio tag de objeto. En el lenguaje de segmentación, un campo es un tag con un nombre con puntos, y admite los operadores de su propio tipo:
AT("XXXXX-XXXXX", "order.amount", gte, 100)Un campo de un objeto anidado o una lista anidada se indica con su nombre completo, como profile.address.city, profile.visits.code u orders.meta.color. Una condición sobre el propio tag de objeto, un objeto anidado o una lista anidada, como profile.address, falla con object tag has no value of its own, use one of its fields.
Un campo con dos listas de objetos por encima, como orders.lines.qty, solo se almacena. El segmento con esa condición se guarda, pero calcularlo o enviarle mensajes falla con a field inside a list nested in a list is stored only and cannot be searched.
Condiciones sobre un ObjectList
Anchor link toUna condición sobre un campo de un tag ObjectList coincide con un usuario cuando al menos un elemento de la lista cumple la condición. Las condiciones sobre campos de la misma lista unidas con AND deben coincidir con el mismo elemento:
AT("XXXXX-XXXXX", "orders.amount", gte, 100) * AT("XXXXX-XXXXX", "orders.status", eq, "paid")Este segmento contiene usuarios con al menos un pedido que es a la vez de 100 o más y pagado. Un usuario con un pedido grande sin pagar y un pedido pequeño pagado no coincide. El mismo elemento se comprueba para los campos de un objeto que está dentro de él: orders.sku igual a A-1 AND orders.meta.color igual a red coinciden con un usuario que tiene un pedido con ambos. Las condiciones unidas con OR no tienen que coincidir con el mismo elemento. Las condiciones sobre dos listas diferentes se comprueban en cada lista por separado.
Algunos operadores funcionan de forma distinta sobre un campo de un tag ObjectList:
notset. Ningún elemento de la lista tiene un valor en este campo. Un usuario sin la lista también coincide.noteq. Al menos un elemento tiene un valor en este campo, y ese valor es distinto del indicado. Los elementos sin el campo no cuentan. Un usuario con pedidos en los estadospaidynewcoincide connoteq "paid".notinsobre un campo List. Ningún elemento contiene ninguno de los valores indicados.notinsobre un campo de otro tipo. Al menos un elemento tiene un valor en este campo que no está entre los valores indicados.
notset y notin sobre un campo List no están ligados al mismo elemento que las demás condiciones unidas con AND. Estas reglas también se aplican a las listas anidadas, como profile.visits.
Usar valores en los mensajes
Anchor link toInserta campos de tags de objeto en notificaciones push, emails, SMS y mensajes de mensajería como WhatsApp con plantillas Liquid. Liquid solo funciona si las plantillas de contenido están habilitadas en tu cuenta. Escribe un campo por su nombre completo a cualquier profundidad:
Your city is {{ profile.address.city }}.Toma un elemento de una lista de objetos por su índice, empezando por 0:
Your first order is {{ orders[0].sku }}, quantity {{ orders[0].lines[0].qty }}.Un índice más allá del final de la lista, o una lista que el usuario no tiene, se muestra como una cadena vacía. Comprueba primero el elemento o establece un valor alternativo con default:
{% if orders[0] %}Your first order is {{ orders[0].sku }}.{% endif %}Your first order is {{ orders[0].sku | default: "on its way" }}.Recorre una lista de objetos, incluida una lista dentro de un elemento:
{% for o in orders %}{{ o.meta.color }}{% for l in o.lines %}{{ l.qty }}{% endfor %}{% endfor %}Los campos solo almacenados, como orders.lines.qty, funcionan en las plantillas igual que los demás campos.
Exportar segmentos con tags de objeto
Anchor link to/exportSegment exporta los campos de los tags de objeto:
- CSV. Cada campo con valor es una columna separada con su nombre completo, como
order.amountoprofile.address.city. Los propios tags de objeto, objetos anidados y listas anidadas no tienen columna. Un campo dentro de una lista de objetos, a cualquier profundidad, contiene los valores distintos de todos los elementos como un array JSON, igual que un tag List:["A-1","B-2"]. El array está ordenado y no muestra de qué elemento procede un valor, así que tampoco conserva el orden de los elementos. Para obtener los elementos completos, exporta enjsonojson_each_line. jsonyjson_each_line. Los tags de objeto vienen anidados, con la misma forma en que los devuelve/getTags. Un tagObjectes una entrada entagscon sus campos enobject.fields, y un objeto anidado dentro de él también lleva sus propios campos enobject.fields, en cada nivel. Un tagObjectListes una entrada con sus elementos enobject_list.items, y lo mismo una lista anidada. Los campos tienen nombres cortos, se ordenan por nombre y llevan su valor bajo una clave con el nombre del tipo:integer,string,list,date,boolean,priceoversion:
{ "name": "profile", "object": { "fields": [ { "name": "address", "object": { "fields": [{ "name": "city", "string": "Berlin" }] } }, { "name": "visits", "object_list": { "items": [{ "fields": [{ "name": "code", "string": "v1" }] }] } } ] }}Un tag ObjectList tiene este aspecto. Los valores enteros vienen como cadenas:
{ "name": "orders", "object_list": { "items": [ { "fields": [{ "name": "amount", "integer": "120" }, { "name": "status", "string": "paid" }] }, { "fields": [{ "name": "amount", "integer": "50" }] } ] }}Un elemento con un objeto anidado y una lista anidada tiene este aspecto:
{ "fields": [ { "name": "meta", "object": { "fields": [{ "name": "color", "string": "red" }] } }, { "name": "lines", "object_list": { "items": [{ "fields": [{ "name": "qty", "integer": "2" }] }] } } ]}Si tagsList nombra un tag de objeto, se exportan todos sus campos, incluidos los anidados.