Recomendaciones de productos entregadas como JSON sin procesar en lugar de como un widget ya generado, para que usted las maquete. Úselas para un widget de diseño propio, una single-page app, una app nativa, una plantilla de email o cualquier superficie en la que usted controla la presentación y solo quiere la selección. Se obtienen con una única solicitud GET.
En el panel: Nueva campaña › App / API › API JSON — Recom. de productos.
Los pasos
Siete pasos: Catálogo, Interacciones, Recomendación, Datos en la respuesta, Código, Automatización y Rendimiento. No hay paso Segmentar: la selección es para quien indique su solicitud.
1. Catálogo
Su catálogo tiene que estar cargado y al día. No se puede recomendar nada que Personyze no conozca. Cada elemento necesita al menos un ID interno, un título y una URL, además de una imagen si su diseño la muestra. El catálogo está en Configuración → Configuración de recomendaciones → Catálogo de productos. Consulte Configurar el feed de productos / contenidos.
2. Interacciones
El motor aprende de lo que la gente hace con los productos: visto, añadido al carrito, comprado. Las vistas, los añadidos al carrito y las compras en su propio sitio web se registran como siempre, desde Configuración → Configuración de recomendaciones → Seguimiento de productos. Su propio diseño es distinto: Personyze no lo dibujó, así que no puede ver lo que pasa en él.
- Clics: haga pasar a la gente por el
click_urlque llega con cada elemento. Abre el producto y registra el clic. - Todo lo que ocurre fuera de su sitio web, como una vista o una compra dentro de su app, tiene que notificarlo usted. Use la API REST de interacciones con productos.
Esta es la razón más habitual por la que una recomendación JSON devuelve resultados pobres o genéricos: el resultado se está mostrando, pero no se está notificando nada de vuelta.
3. Recomendación
Elija el algoritmo. El selector es el mismo que usan los widgets en el sitio, agrupado en Personalizados y de comportamiento; Ventas cruzadas, co-vistas y ventas adicionales; Historial del visitante; Eventos del catálogo; y Personalizado. Una solicitud no llega desde una página de su sitio, así que la fila Página ofrece en su lugar lo que hizo la persona:
- General: ningún elemento en particular.
- Items they viewed: anclado a lo que vio.
- Items in their cart: anclado a su carrito.
- Items they purchased: anclado a lo que compró.
Muchos algoritmos tienen ajustes propios, que se muestran en la tarjeta:
- Periodo: Recientemente, Hoy, En los últimos 2 días, En los últimos 4 días, En la última semana o En todo el tiempo. Las ventanas más cortas siguen las tendencias; las más largas son más estables.
- Tomado de: qué parte del catálogo. Por ejemplo, cualquier categoría, las categorías que vio, la categoría de su último carrito o sus intereses notificados.
- Ordenar por: Visto, Añadidos al catálogo recientemente, Comprados, Añadido al carrito, Añadido a la lista de deseos, Barato, Mejor valorados o Mayor beneficio.
La tarjeta Salida fija cuántos elementos se devuelven (hasta 12), los Algoritmos de respaldo que se ejecutan cuando el principal devuelve demasiado pocos, y Rellenar celdas vacías para completar un resultado corto con elementos populares. Debajo, los filtros acotan el conjunto. Puede omitir los elementos con los que la persona ya interactuó, restringir a categorías elegidas o a elementos con imagen o con precio, o escribir reglas personalizadas sobre cualquier campo del catálogo. Los elementos agotados se excluyen automáticamente.
Sobre los algoritmos en sí, consulte Algoritmos de recomendación. Consulte también Filtros y Respaldos.
4. Datos en la respuesta
Personyze responde con un array JSON de objetos, uno por producto, con los campos que elija aquí. Cada fila empareja un Field on Personyze con su Name in JSON result, así que usted define su propio contrato de respuesta. Elija exactamente lo que necesita su código de presentación y nada más.
Cada producto llega además con un click_url, lo incluya o no en la lista. Envíe al usuario a esa URL: abre el producto y registra el clic, y a partir de ella se construyen las estadísticas de vistas y clics.
Selección típica para un widget de productos:
[
{
"internal_id": "nw-p001",
"title": "Alpine Shell",
"price": 249,
"image_1": "https://example.test/img/alpine-shell.jpg",
"url": "https://example.test/shop/alpine-shell",
"click_url": "https://pic.personyze.com/href/k=…"
},
...
]Se puede incluir cualquier campo personalizado del catálogo. Si su diseño muestra una insignia, una valoración o un mensaje de stock, asigne aquí ese campo en lugar de buscarlo por separado.
5. Código
El paso Código, titulado Request URL, le da URL ya preparadas. Aparecen una vez guardada la campaña. Haga una solicitud GET a una de ellas y las recomendaciones llegan como JSON. Lo que ponga al final indica para quién, o para qué, son:
| La URL termina en | Recomienda para |
|---|---|
/email={INSERT EMAIL HERE} |
La persona con esa dirección de email. Una dirección que Personyze no ha visto crea un perfil, así que la primera solicitud la da de alta. |
/internal_id={INSERT INTERNAL ID HERE} |
La persona con su propio ID para ella, guardado en su perfil como ID interno. Un ID desconocido también crea un perfil. |
/u={INSERT PERSONYZE USER ID HERE} |
El ID numérico de usuario del propio Personyze, el que el tracker expone en su sitio. Cualquier cosa que no sea un número se rechaza con Invalid parameter. |
/item_internal_id={INSERT ITEM INTERNAL ID HERE} |
Ninguna persona: productos relacionados con ese producto. Son elementos vistos o comprados junto con él, o los más populares de su categoría. |
Una quinta URL, que termina en /get[]=…, no recomienda nada. Devuelve los campos que haya elegido para los productos que indique, hasta 50 por solicitud, y su periodo (1 día, 2 días, Semana, Todo el tiempo) fija la ventana de los contadores de interacción que haya pedido.
La solicitud es la misma desde un backend, una app o una plantilla de email. Si su app ya notifica a Personyze a través del SDK móvil, también puede entregar allí la selección con una campaña Recom. de productos para apps.
6. Automatización
Este paso es opcional. Añada reglas que le avisen, o que actúen, cuando las cifras de esta campaña crucen un umbral. Consulte Automatización.
7. Rendimiento
El paso Rendimiento muestra las Estadísticas JSON API. Visto cuenta las recomendaciones servidas a su aplicación. Con clic cuenta los usuarios que pasaron por un click_url devuelto y llegaron a su sitio, como % de Visto. Añadido al carrito y Comprados siguen en la misma sesión, cada uno como % del paso anterior. Al lado están las transacciones, los ingresos atribuidos y su parte de los ingresos del sitio. Solo refleja lo que Personyze puede ver: sin el click_url, los clics y todo lo que viene después quedan sin contar. Cada cifra se explica en Recomendaciones de productos y de contenido.
Nota: no hay paso QA
A diferencia de las campañas en el sitio, las campañas de API JSON no tienen paso QA, porque no hay contenido generado que el panel pueda previsualizar. Valide solicitando usted mismo una URL y leyendo la respuesta. Compruebe que recibe el número de elementos que espera, que los campos que seleccionó están presentes y que los valores están rellenos y no vacíos. Una solicitud que no se puede responder devuelve igualmente JSON, como {"error": "…"}. Por ejemplo, No recommendations for this user significa que el algoritmo no encontró nada para esa persona y no había ningún respaldo con el que rellenar.
Relacionado
- Recomendaciones fuera de su sitio — por dónde empezar
- API JSON — Recomendaciones de contenido
- Objeto products e interacciones con productos de la API REST.
- Implementar una app de recomendaciones a medida, la vía del SDK y de REST para apps, con un ejemplo completo.